자격 증명의 사용자 이름과 비밀을 토큰 끝점으로 보냅니다. 이 교환에는 무기명 토큰이 필요하지 않습니다. 반환된 액세스 토큰을 후속 REST 요청에서 전달자 토큰으로 사용합니다.
password: 이 JSON 필드에는 계정 로그인 비밀번호가 아닌 API 자격 증명 비밀번호가 포함됩니다.
첫 번째 요청을 하세요
예제를 로컬에서 실행합니다. 자격 증명을 묻는 메시지를 표시하고 액세스 토큰을 얻은 다음 장치의 첫 번째 페이지를 나열합니다. 토큰을 비공개로 유지하세요. 이러한 문서 페이지에서는 자격 증명을 요청하거나 저장하지 않습니다.
언어를 선택하고 아래 나열된 종속성을 설치합니다. 예시에서는 Cloud API 주소를 사용합니다. 문서, 지원 티켓 또는 공유 로그에 실제 비밀을 붙여넣지 마십시오.
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" }액세스 토큰 응답
자격 증명 교환은 아래 필드를 반환합니다. 여기에 표시된 토큰은 자리 표시자입니다. 수명은 초 단위이고 만료 타임스탬프는 UTC입니다.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}자격 증명이 발급된 토큰은 30분 동안 지속됩니다. 이 교환은 새로 고침 토큰을 반환하지 않습니다. 토큰이 만료되면 자격 증명을 다시 교환하십시오. 쓰기가 중단된 경우 다시 제출하기 전에 해당 결과와 엔드포인트의 재시도 규칙을 확인하세요.
액세스 토큰을 사용할 수 있는 위치를 선택하세요.
audience: "api"- REST API 요청에 이 값을 사용합니다. 대상 필드가 생략된 경우 기본값입니다.
audience: "mcp"- 이 값은 베어러 토큰으로 구성된 MCP 클라이언트에만 사용하십시오. 자격 증명에는 MCP가 활성화되어 있어야 합니다. API와 MCP 토큰은 서로 바꿔서 사용할 수 없습니다.
인증에 실패한 경우
- 401
- 사용자 이름과 비밀번호, 자격 증명 만료 및 해지를 확인하세요. 인증된 요청에서는 토큰 만료 및 대상도 확인하세요. 동일한 잘못된 자격 증명을 반복해도 문제가 해결되지 않습니다.
- 403
- 응답코드와 메시지를 확인하세요. 권한, 네트워크 또는 국가 정책, 소유자의 현재 액세스 또는 추가 기능 자격에 따라 액세스가 차단될 수 있습니다. 새 토큰은 이러한 검사를 우회하지 않습니다.
- 429 ·
Retry-After - 다시 시도하기 전에 응답 헤더에 지정된 지연을 기다립니다. 기본 토큰 시도 제한은 각 릴레이에서 소스 IP당 분당 10회입니다. 플랫폼 설정은 이 제한을 변경할 수 있습니다.