Envoyez le nom d'utilisateur et le secret de vos informations d'identification au point de terminaison du jeton. Cet échange n'a pas besoin de jeton au porteur. Utilisez le jeton d'accès renvoyé comme jeton de support lors des requêtes REST suivantes.
password: Ce champ JSON contient le secret de vos informations d'identification API, et non le mot de passe de connexion à votre compte.
Faites votre première demande
Exécutez l'exemple localement. Il vous demande vos informations d'identification, obtient un jeton d'accès et répertorie la première page des appareils. Gardez le jeton privé. Ces pages de documentation ne demandent ni ne stockent jamais d’informations d’identification.
Choisissez une langue et installez les dépendances répertoriées ci-dessous. Les exemples utilisent l'adresse de l'API Cloud. Ne collez jamais de vrais secrets dans la documentation, les tickets d’assistance ou les journaux partagés.
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" }Réponse du jeton d'accès
L'échange d'informations d'identification renvoie les champs ci-dessous. Le jeton affiché ici est un espace réservé. La durée de vie est en secondes et l'horodatage d'expiration est UTC.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Les jetons émis par les identifiants durent 30 minutes. Cet échange ne renvoie pas de jeton d'actualisation. Lorsqu'un jeton expire, échangez à nouveau les informations d'identification. Pour une écriture interrompue, vérifiez son résultat et les règles de nouvelle tentative du point de terminaison avant de la soumettre à nouveau.
Choisissez où le jeton d'accès peut être utilisé
audience: "api"- Utilisez cette valeur pour les requêtes API REST. Il s'agit de la valeur par défaut lorsque le champ d'audience est omis.
audience: "mcp"- Utilisez cette valeur uniquement pour un client MCP configuré avec un jeton de support. MCP doit être activé pour les informations d'identification. Les jetons API et MCP ne peuvent pas être utilisés de manière interchangeable.
Si l'authentification échoue
- 401
- Vérifiez le nom d'utilisateur et le secret, l'expiration et la révocation des informations d'identification. Sur une demande authentifiée, vérifiez également l’expiration et l’audience du jeton. Répéter le même identifiant invalide ne résoudra pas le problème.
- 403
- Vérifiez le code de réponse et le message. L'accès peut être bloqué par les autorisations, la politique du réseau ou du pays, l'accès actuel du propriétaire ou l'éligibilité des modules complémentaires. Un nouveau jeton ne contourne pas ces contrôles.
- 429 ·
Retry-After - Attendez le délai indiqué dans l'en-tête de réponse avant de réessayer. La limite par défaut de tentatives de jetons est de 10 par IP source et par minute sur chaque relais. Les paramètres de la plateforme peuvent modifier cette limite.