Anza

Washa ufikiaji, unda kitambulisho na ufanye ombi lako la kwanza la API.

1. Washa ufikiaji wa API

   Mmiliki wa Shirika huwezesha ufikiaji wa API na MCP katika Mipangilio. Nyongeza iliyoshirikiwa hugharimu dola 20 za Marekani kwa kila shirika kwa mwezi wa kalenda kwa ajili ya Wingu na usakinishaji wa Self-Hosted uliounganishwa. Wakati wa jaribio, Mipangilio inaonyesha kama ufikiaji wa API na MCP umejumuishwa. Ikiwa inaonyesha Imejumuishwa katika jaribio, washa ufikiaji hapo; vinginevyo kagua chaguo la uanzishaji lililolipwa. Kuzima ufikiaji uliolipwa hakuondoi ada ya mwezi wa sasa.

   Kwa Mwenyeji Mwenyewe, washa programu jalizi katika shirika lako la Wingu linalomiliki, acha usakinishaji ukamilishe ukaguzi wake wa leseni, kisha uwashe ufikiaji wa API katika Mipangilio ya usakinishaji. Tumia anwani ya usakinishaji ya HTTPS badala ya anwani ya Cloud API katika mifano hii.

2. Tengeneza kitambulisho

   Unda kitambulisho cha API katika Mipangilio. Anza na Mali kwa muhtasari huu pekee. Chagua shirika zima au kampuni moja kama upeo wake. Upeo hauwezi kubadilishwa baadaye; unda kitambulisho kipya ikiwa unahitaji upeo tofauti.

3. Hifadhi siri

   Kitambulisho cha API kina jina la mtumiaji na siri. Siri huonyeshwa tu unapoiunda au kuizungusha. Ihifadhi kwenye kidhibiti cha nenosiri au duka la siri. Inaweza kutumika tena hadi kufutwa au kumalizika muda wake; si msimbo wa uthibitishaji wa mara moja au nenosiri lako la kuingia.

4. 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.

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

Uthibitishaji →

Ruhusa na upeo

Kipimo cha awali huchagua uwezo, si kiwango cha ufikiaji. Mipangilio huunda vitambulisho vipya kwa kutumia FullAccess; uwezo uliochaguliwa bado unazuia ufikiaji. Kagua ruhusa maalum kabla ya kuhifadhi. ReadOnly na ReadWrite huelezea vitambulisho vya zamani au vilivyoundwa kando, si majina yaliyowekwa awali.

Shirika, kampuni na tovuti

Shirika ndio mpaka wa ngazi ya juu wa akaunti yako. Makampuni hutenganisha wateja au vitengo vya biashara ndani yake. Vifaa vya vikundi vya tovuti ndani ya kampuni. Kitambulisho kilichowekwa na kampuni hakiwezi kufikia data ya kampuni nyingine.