Uthibitishaji

Tuma jina la mtumiaji la kitambulisho chako na siri kwa kituo cha tokeni. Ubadilishanaji huu hauhitaji tokeni ya mtoaji. Tumia tokeni ya ufikiaji iliyorejeshwa kama tokeni ya mtoaji kwenye maombi yanayofuata ya REST.

password: Sehemu hii ya JSON inabeba siri ya kitambulisho chako cha API, si nenosiri lako la kuingia katika akaunti.

Fanya ombi lako la kwanza

Endesha mfano ndani ya nchi. Inakuomba upate kitambulisho chako, hupata tokeni ya ufikiaji na kuorodhesha ukurasa wa kwanza wa vifaa. Weka ishara ya faragha. Kurasa hizi za hati haziulizi wala hazihifadhi kitambulisho.

Chagua lugha na usakinishe vitegemezi vilivyoorodheshwa hapa chini. Mifano hutumia anwani ya Cloud API. Usibandike kamwe siri za kweli kwenye hati, tikiti za usaidizi au kumbukumbu zinazoshirikiwa.

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

Mwitikio wa ishara ya ufikiaji

Ubadilishanaji wa hati hurejesha sehemu zilizo hapa chini. Ishara iliyoonyeshwa hapa ni kishikilia nafasi. Muda wa maisha ni sekunde na muhuri wa muda wa kuisha ni UTC.

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

Tokeni zinazotolewa na hati hudumu kwa dakika 30. Ubadilishanaji huu haurudishi tokeni ya kuonyesha upya. Tokeni inapoisha, badilisha kitambulisho tena. Kwa uandishi uliokatizwa, angalia matokeo yake na kanuni za kujaribu tena za mwisho kabla ya kuiwasilisha tena.

Chagua mahali ambapo ishara ya ufikiaji inaweza kutumika

audience: "api"

Tumia thamani hii kwa maombi ya REST API. Ni chaguo-msingi wakati uga wa hadhira umeachwa.

audience: "mcp"

Tumia thamani hii kwa mteja wa MCP pekee aliyesanidiwa kwa tokeni ya mbebaji. Kitambulisho lazima kiwe na MCP. Tokeni za API na MCP haziwezi kutumika kwa kubadilishana.

Ikiwa uthibitishaji utashindwa

401

Angalia jina la mtumiaji na siri, mwisho wa kitambulisho na ubatilishaji. Kwa ombi lililoidhinishwa, angalia pia kuisha kwa tokeni na hadhira. Kurudia kitambulisho sawa hakutasuluhisha tatizo.

403

Angalia msimbo wa majibu na ujumbe. Ufikiaji unaweza kuzuiwa na ruhusa, sera ya mtandao au nchi, ufikiaji wa sasa wa Mmiliki, au ustahiki wa programu jalizi. Tokeni mpya haiepushi hundi hizo.

429 · Retry-After

Subiri ucheleweshaji uliotolewa kwenye kichwa cha majibu kabla ya kujaribu tena. Kikomo chaguo-msingi cha kujaribu tokeni ni 10 kwa kila IP chanzo kwa dakika kwenye kila Relay. Mipangilio ya jukwaa inaweza kubadilisha kikomo hiki.

Marejeo ya API → POST /v1/auth/token

Unganisha msaidizi wa AI →