Pagpapatunay

Ipadala ang username at sikreto ng iyong kredensyal sa token endpoint. Ang palitan na ito ay hindi nangangailangan ng token ng maydala. Gamitin ang ibinalik na access token bilang bearer token sa mga susunod na kahilingan sa REST.

password: Dinadala ng field na ito ng JSON ang lihim ng kredensyal ng iyong API, hindi ang password sa pag-login ng iyong account.

Gawin ang iyong unang kahilingan

Patakbuhin ang halimbawa nang lokal. Nag-prompt ito para sa iyong kredensyal, nakakakuha ng token ng pag-access at naglilista ng unang pahina ng mga device. Panatilihing pribado ang token. Ang mga pahina ng dokumentasyong ito ay hindi kailanman humihingi o nag-iimbak ng mga kredensyal.

Pumili ng wika at i-install ang mga dependency na nakalista sa ibaba. Ginagamit ng mga halimbawa ang Cloud API address. Huwag kailanman i-paste ang mga totoong lihim sa dokumentasyon, mga tiket ng suporta o mga nakabahaging log.

$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" }

I-access ang tugon ng token

Ibinabalik ng credential exchange ang mga field sa ibaba. Ang token na ipinapakita dito ay isang placeholder. Ang lifetime ay nasa segundo at ang expiry timestamp ay UTC.

{
  "accessToken": "<access-token>",
  "tokenType": "Bearer",
  "expiresIn": 1800,
  "expiresAtUtc": "2026-10-26T12:30:00Z"
}

Ang mga token na ibinigay ng kredensyal ay tumatagal ng 30 minuto. Ang exchange na ito ay hindi nagbabalik ng refresh token. Kapag nag-expire ang isang token, palitan muli ang kredensyal. Para sa naantala na pagsusulat, tingnan ang kinalabasan nito at ang mga panuntunan sa muling pagsubok ng endpoint bago ito muling isumite.

Piliin kung saan magagamit ang access token

audience: "api"

Gamitin ang halagang ito para sa mga kahilingan sa REST API. Ito ang default kapag ang field ng audience ay tinanggal.

audience: "mcp"

Gamitin lang ang value na ito para sa isang MCP client na na-configure na may bearer token. Ang kredensyal ay dapat na pinagana ang MCP. Hindi maaaring palitan ang mga token ng API at MCP.

Kung nabigo ang pagpapatunay

401

Suriin ang username at sikreto, pag-expire ng kredensyal at pagbawi. Sa isang napatotohanang kahilingan, tingnan din ang pag-expire ng token at audience. Ang pag-uulit sa parehong di-wastong kredensyal ay hindi maaayos ang problema.

403

Suriin ang response code at mensahe. Maaaring ma-block ang pag-access ng mga pahintulot, patakaran sa network o bansa, kasalukuyang pag-access ng May-ari, o pagiging karapat-dapat sa add-on. Ang isang bagong token ay hindi lumalampas sa mga tseke na iyon.

429 · Retry-After

Hintayin ang pagkaantala na ibinigay sa header ng tugon bago subukang muli. Ang default na limitasyon sa token-attempt ay 10 bawat source IP kada minuto sa bawat Relay. Maaaring baguhin ng mga setting ng platform ang limitasyong ito.

Sanggunian ng API → POST /v1/auth/token

Ikonekta ang isang AI assistant →