Senden Sie den Benutzernamen und das Geheimnis Ihrer Anmeldeinformationen an den Token-Endpunkt. Für diese Börse ist kein Inhabertoken erforderlich. Verwenden Sie das zurückgegebene Zugriffstoken als Trägertoken für nachfolgende REST-Anfragen.
password: Dieses JSON-Feld enthält Ihr API-Zugangsgeheimnis, nicht Ihr Konto-Login-Passwort.
Stellen Sie Ihre erste Anfrage
Führen Sie das Beispiel lokal aus. Es fordert Sie zur Eingabe Ihrer Anmeldedaten auf, ruft ein Zugriffstoken ab und listet die erste Seite der Geräte auf. Halten Sie den Token privat. Auf diesen Dokumentationsseiten werden niemals Anmeldeinformationen abgefragt oder gespeichert.
Wählen Sie eine Sprache und installieren Sie die unten aufgeführten Abhängigkeiten. Die Beispiele verwenden die Cloud-API-Adresse. Fügen Sie niemals echte Geheimnisse in Dokumentationen, Support-Tickets oder freigegebene Protokolle ein.
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" }Zugriffstoken-Antwort
Der Anmeldeinformationsaustausch gibt die folgenden Felder zurück. Der hier angezeigte Token ist ein Platzhalter. Die Lebensdauer wird in Sekunden angegeben und der Ablaufzeitstempel ist UTC.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Von Anmeldeinformationen ausgestellte Token sind 30 Minuten gültig. Dieser Austausch gibt kein Aktualisierungstoken zurück. Wenn ein Token abläuft, tauschen Sie die Anmeldeinformationen erneut aus. Überprüfen Sie bei einem unterbrochenen Schreibvorgang dessen Ergebnis und die Wiederholungsregeln des Endpunkts, bevor Sie ihn erneut senden.
Wählen Sie aus, wo das Zugriffstoken verwendet werden kann
audience: "api"- Verwenden Sie diesen Wert für REST-API-Anfragen. Dies ist die Standardeinstellung, wenn das Zielgruppenfeld weggelassen wird.
audience: "mcp"- Verwenden Sie diesen Wert nur für einen MCP-Client, der mit einem Bearer-Token konfiguriert ist. Für die Anmeldeinformationen muss MCP aktiviert sein. API- und MCP-Token können nicht austauschbar verwendet werden.
Wenn die Authentifizierung fehlschlägt
- 401
- Überprüfen Sie den Benutzernamen und das Geheimnis, den Ablauf und den Widerruf der Anmeldeinformationen. Überprüfen Sie bei einer authentifizierten Anfrage auch den Ablauf des Tokens und die Zielgruppe. Das Wiederholen derselben ungültigen Anmeldeinformationen wird das Problem nicht beheben.
- 403
- Überprüfen Sie den Antwortcode und die Nachricht. Der Zugriff kann durch Berechtigungen, Netzwerk- oder Länderrichtlinien, den aktuellen Zugriff des Eigentümers oder die Berechtigung für Add-ons blockiert werden. Ein neuer Token umgeht diese Prüfungen nicht.
- 429 ·
Retry-After - Warten Sie die im Antwortheader angegebene Verzögerung ab, bevor Sie es erneut versuchen. Das Standardlimit für Token-Versuche beträgt 10 pro Quell-IP pro Minute auf jedem Relay. Plattformeinstellungen können dieses Limit ändern.