Seol ainm úsáideora agus rún do dhintiúir chuig críochphointe an chomhartha. Níl comhartha iompróra ag teastáil ón malartú seo. Úsáid an comhartha rochtana ar ais mar chomhartha iompróra ar iarratais REST ina dhiaidh sin.
password: Tá do rún dintiúir API ag baint leis an réimse JSON seo, ní do phasfhocal logáil isteach chuntais.
Déan do chéad iarratas
Rith an sampla go háitiúil. Spreagann sé do dhintiúir, faigheann sé comhartha rochtana agus liostaíonn sé an chéad leathanach de ghléasanna. Coinnigh an comhartha príobháideach. Ní iarrann nó ní stórálann na leathanaigh doiciméadaithe seo dintiúir.
Roghnaigh teanga agus suiteáil na spleáchais atá liostaithe thíos. Úsáideann na samplaí an seoladh Cloud API. Ná greamaigh fíor-rúin riamh isteach i gcáipéisíocht, i dticéad tacaíochta nó i logaí comhroinnte.
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" }Freagra dearbhán rochtana
Tugann an malartú dintiúr na réimsí thíos. Is sealbhóir áit é an comhartha a thaispeántar anseo. Tá an saolré i soicindí agus is é UTC an stampa ama éaga.
{
"accessToken": "<access-token>",
"tokenType": "Bearer",
"expiresIn": 1800,
"expiresAtUtc": "2026-10-26T12:30:00Z"
}Maireann comharthaí a eisítear dintiúir 30 nóiméad. Ní thugann an malartú seo comhartha athnuachana ar ais. Nuair a théann comhartha in éag, malartófar an dintiúr arís. Chun scríobh isteach a fháil, seiceáil an toradh atá air agus rialacha atriail an chríochphointe sula gcuireann tú isteach arís é.
Roghnaigh an áit ar féidir an comhartha rochtana a úsáid
audience: "api"- Úsáid an luach seo le haghaidh iarratais REST API. Is é an réamhshocrú é nuair a fhágtar an réimse lucht féachana ar lár.
audience: "mcp"- Bain úsáid as an luach seo ach amháin le haghaidh cliant MCP atá cumraithe le comhartha iompróra. Ní mór go mbeadh MCP cumasaithe ag an dintiúir. Ní féidir comharthaí API agus MCP a úsáid go hidirmhalartaithe.
Má theipeann ar fhíordheimhniú
- 401
- Seiceáil an t-ainm úsáideora agus an rún, dul in éag credential agus cúlghairm. Ar iarratas fíordheimhnithe, seiceáil freisin éaga an chomhartha agus an lucht éisteachta. Má dhéantar an scríbhinn neamhbhailí céanna arís, ní réiteoidh sé sin an fhadhb.
- 403
- Seiceáil an cód freagartha agus an teachtaireacht. Féadfaidh ceadanna, beartas líonra nó tíre, rochtain reatha an Úinéara, nó incháilitheacht an bhreiseáin bac a chur ar rochtain. Ní sheachnaíonn comhartha nua na seiceálacha sin.
- 429 ·
Retry-After - Fan leis an moill a thugtar sa cheanntásc freagartha sula ndéanfaidh tú iarracht eile. Is é an teorainn réamhshocraithe iarracht chomhartha ná 10 in aghaidh an fhoinse IP in aghaidh an nóiméid ar gach Leaschraolacháin. Is féidir le socruithe ardáin an teorainn seo a athrú.