Stuur de gebruikersnaam en het geheim van uw inloggegevens naar het tokeneindpunt. Voor deze uitwisseling is geen token aan toonder nodig. Gebruik het geretourneerde toegangstoken als dragertoken bij volgende REST-aanvragen.
password: Dit JSON-veld bevat het geheim van uw API-inloggegevens, niet het inlogwachtwoord van uw account.
Doe uw eerste verzoek
Voer het voorbeeld lokaal uit. Het vraagt om uw inloggegevens, verkrijgt een toegangstoken en vermeldt de eerste pagina met apparaten. Houd het token privé. Deze documentatiepagina's vragen nooit om inloggegevens en slaan deze ook niet op.
Kies een taal en installeer de onderstaande afhankelijkheden. In de voorbeelden wordt het Cloud API-adres gebruikt. Plak nooit echte geheimen in documentatie, supporttickets of gedeelde logboeken.
cURL: Bash + jq · Python: requests · C#: .NET 8+ (HttpClient)
C#: dotnet new console → Program.cs → dotnet run
$credential = Get-Credential
$body = @{
username = $credential.UserName
password = $credential.GetNetworkCredential().Password
audience = "api"
} | ConvertTo-Json
$token = Invoke-RestMethod -Method Post -Uri "https://api.remotegymp.com/v1/auth/token" -ContentType "application/json" -Body $body
$env:RG_API_TOKEN = $token.accessToken
Invoke-RestMethod -Uri "https://api.remotegymp.com/v1/devices?pageSize=25" -Headers @{ Authorization = "Bearer $env:RG_API_TOKEN" }Toegangstokenantwoord
De inloggegevensuitwisseling retourneert de onderstaande velden. Het hier getoonde token is een tijdelijke aanduiding. De levensduur is in seconden en het vervaltijdstempel is UTC.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Door inloggegevens uitgegeven tokens duren 30 minuten. Deze uitwisseling retourneert geen vernieuwingstoken. Wanneer een token verloopt, wisselt u de inloggegevens opnieuw uit. Controleer bij een onderbroken schrijfbewerking het resultaat ervan en de regels voor opnieuw proberen van het eindpunt voordat u deze opnieuw verzendt.
Kies waar het toegangstoken gebruikt kan worden
audience: "api"- Gebruik deze waarde voor REST API-aanvragen. Dit is de standaardwaarde wanneer het doelgroepveld wordt weggelaten.
audience: "mcp"- Gebruik deze waarde alleen voor een MCP-client die is geconfigureerd met een bearertoken. Voor de referentie moet MCP zijn ingeschakeld. API- en MCP-tokens kunnen niet door elkaar worden gebruikt.
Als authenticatie mislukt
- 401
- Controleer de gebruikersnaam en het geheim, het verlopen en intrekken van de inloggegevens. Controleer bij een geverifieerd verzoek ook de vervaldatum van het token en de doelgroep. Het herhalen van dezelfde ongeldige identificatie zal het probleem niet oplossen.
- 403
- Controleer de responscode en het bericht. De toegang kan worden geblokkeerd vanwege machtigingen, netwerk- of landbeleid, de huidige toegang van de Eigenaar of de geschiktheid van add-ons. Een nieuw token omzeilt deze controles niet.
- 429 ·
Retry-After - Wacht totdat de vertraging in de antwoordheader is verstreken voordat u het opnieuw probeert. De standaardlimiet voor tokenpogingen is 10 per bron-IP per minuut op elke relay. Platforminstellingen kunnen deze limiet wijzigen.