Envíe el nombre de usuario y el secreto de su credencial al punto final del token. Este intercambio no necesita un token al portador. Utilice el token de acceso devuelto como token de portador en solicitudes REST posteriores.
password: Este campo JSON contiene el secreto de su credencial API, no la contraseña de inicio de sesión de su cuenta.
Haz tu primera solicitud
Ejecute el ejemplo localmente. Solicita su credencial, obtiene un token de acceso y enumera la primera página de dispositivos. Mantenga el token en privado. Estas páginas de documentación nunca solicitan ni almacenan credenciales.
Elija un idioma e instale las dependencias que se enumeran a continuación. Los ejemplos utilizan la dirección de la API de la nube. Nunca pegue secretos reales en documentación, tickets de soporte o registros compartidos.
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" }Respuesta del token de acceso
El intercambio de credenciales devuelve los campos siguientes. El token que se muestra aquí es un marcador de posición. La vida útil está en segundos y la marca de tiempo de vencimiento es UTC.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Los tokens emitidos por credenciales duran 30 minutos. Este intercambio no devuelve un token de actualización. Cuando un token caduque, intercambie la credencial nuevamente. Para una escritura interrumpida, verifique su resultado y las reglas de reintento del punto final antes de volver a enviarla.
Elija dónde se puede utilizar el token de acceso.
audience: "api"- Utilice este valor para solicitudes de API REST. Es el valor predeterminado cuando se omite el campo de audiencia.
audience: "mcp"- Utilice este valor solo para un cliente MCP configurado con un token de portador. La credencial debe tener MCP habilitado. Los tokens API y MCP no se pueden utilizar indistintamente.
Si la autenticación falla
- 401
- Verificar el nombre de usuario y secreto, caducidad y revocación de la credencial. En una solicitud autenticada, verifique también la caducidad del token y la audiencia. Repetir la misma credencial no válida no solucionará el problema.
- 403
- Verifique el código de respuesta y el mensaje. El acceso puede estar bloqueado por permisos, política de red o país, el acceso actual del Propietario o la elegibilidad de complementos. Un nuevo token no pasa por alto esos controles.
- 429 ·
Retry-After - Espere el retraso indicado en el encabezado de respuesta antes de volver a intentarlo. El límite predeterminado de intentos de token es 10 por IP de origen por minuto en cada retransmisión. La configuración de la plataforma puede cambiar este límite.