Invia il nome utente e il segreto della tua credenziale all'endpoint del token. Questo scambio non necessita di un token al portatore. Utilizza il token di accesso restituito come token di connessione nelle successive richieste REST.
password: Questo campo JSON contiene il segreto della tua credenziale API, non la password di accesso all'account.
Fai la tua prima richiesta
Eseguire l'esempio localmente. Richiede le credenziali, ottiene un token di accesso ed elenca la prima pagina dei dispositivi. Mantieni il token privato. Queste pagine di documentazione non richiedono né memorizzano mai le credenziali.
Scegli una lingua e installa le dipendenze elencate di seguito. Gli esempi utilizzano l'indirizzo API Cloud. Non incollare mai veri segreti nella documentazione, nei ticket di supporto o nei registri condivisi.
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" }Risposta del token di accesso
Lo scambio di credenziali restituisce i campi sottostanti. Il token mostrato qui è un segnaposto. La durata è espressa in secondi e il timestamp di scadenza è UTC.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}I token emessi dalle credenziali durano 30 minuti. Questo scambio non restituisce un token di aggiornamento. Quando un token scade, scambia nuovamente la credenziale. Per una scrittura interrotta, controllarne l'esito e le regole di tentativo dell'endpoint prima di inviarla nuovamente.
Scegli dove può essere utilizzato il token di accesso
audience: "api"- Utilizzare questo valore per le richieste API REST. È l'impostazione predefinita quando il campo del pubblico viene omesso.
audience: "mcp"- Utilizzare questo valore solo per un client MCP configurato con un token di connessione. La credenziale deve avere MCP abilitato. I token API e MCP non possono essere utilizzati in modo intercambiabile.
Se l'autenticazione fallisce
- 401
- Controlla nome utente e segreto, scadenza e revoca delle credenziali. In una richiesta autenticata, controlla anche la scadenza e il pubblico del token. La ripetizione della stessa credenziale non valida non risolverà il problema.
- 403
- Controllare il codice di risposta e il messaggio. L'accesso potrebbe essere bloccato da autorizzazioni, criteri di rete o nazionali, dall'accesso corrente del Proprietario o dall'idoneità dei componenti aggiuntivi. Un nuovo token non aggira questi controlli.
- 429 ·
Retry-After - Attendere il ritardo indicato nell'intestazione della risposta prima di riprovare. Il limite predefinito di tentativi di token è 10 per IP di origine al minuto su ciascun Relay. Le impostazioni della piattaforma possono modificare questo limite.