Send legitimasjonens brukernavn og hemmelighet til token-endepunktet. Denne utvekslingen trenger ikke en bærerbrikke. Bruk det returnerte tilgangstokenet som bærertoken på etterfølgende REST-forespørsler.
password: Dette JSON-feltet inneholder din API-legitimasjonshemmelighet, ikke påloggingspassordet for kontoen din.
Lag din første forespørsel
Kjør eksemplet lokalt. Den ber om legitimasjonen din, får et tilgangstoken og viser den første siden med enheter. Hold tokenet privat. Disse dokumentasjonssidene ber aldri om eller lagrer legitimasjon.
Velg et språk og installer avhengighetene som er oppført nedenfor. Eksemplene bruker Cloud API-adressen. Lim aldri inn ekte hemmeligheter i dokumentasjon, støttebilletter eller delte logger.
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" }Svar på tilgangstoken
Påloggingsutvekslingen returnerer feltene nedenfor. Tokenet som vises her er en plassholder. Levetiden er i sekunder og utløpstidsstempelet er UTC.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Legitimasjonsutstedte tokens varer i 30 minutter. Denne utvekslingen returnerer ikke et oppdateringstoken. Når et token utløper, bytt ut legitimasjonen igjen. For en avbrutt skriving, sjekk resultatet og endepunktets gjenforsøksregler før du sender det inn på nytt.
Velg hvor tilgangstokenet kan brukes
audience: "api"- Bruk denne verdien for REST API-forespørsler. Det er standard når målgruppefeltet er utelatt.
audience: "mcp"- Bruk denne verdien kun for en MCP-klient konfigurert med et bærertoken. Påloggingsinformasjonen må ha MCP aktivert. API- og MCP-tokens kan ikke brukes om hverandre.
Hvis autentisering mislykkes
- 401
- Sjekk brukernavnet og hemmeligheten, utløp av legitimasjon og tilbakekalling. På en autentisert forespørsel, kontroller også tokens utløp og publikum. Å gjenta den samme ugyldige legitimasjonen vil ikke løse problemet.
- 403
- Sjekk svarkoden og meldingen. Tilgang kan blokkeres av tillatelser, nettverks- eller landspolicy, eierens nåværende tilgang eller tilleggskvalifisering. Et nytt token omgår ikke disse sjekkene.
- 429 ·
Retry-After - Vent på forsinkelsen gitt i svarhodet før du prøver igjen. Standard grense for tokenforsøk er 10 per kilde-IP per minutt på hvert relé. Plattforminnstillinger kan endre denne grensen.