तुमच्या क्रेडेन्शियलचे वापरकर्तानाव आणि गुप्त टोकन एंडपॉईंटवर पाठवा. या एक्सचेंजला बेअरर टोकनची आवश्यकता नाही. त्यानंतरच्या REST विनंत्यांवर वाहक टोकन म्हणून परत केलेले प्रवेश टोकन वापरा.
password: या JSON फील्डमध्ये तुमचे API क्रेडेंशियल गुपित आहे, तुमच्या खात्याचा लॉगिन पासवर्ड नाही.
तुमची पहिली विनंती करा
उदाहरण स्थानिक पातळीवर चालवा. ते तुमच्या क्रेडेन्शियलसाठी प्रॉम्प्ट करते, ऍक्सेस टोकन मिळवते आणि डिव्हाइसेसच्या पहिल्या पानाची सूची देते. टोकन खाजगी ठेवा. ही दस्तऐवजीकरण पृष्ठे कधीही क्रेडेन्शियल्सची मागणी करत नाहीत किंवा संग्रहित करत नाहीत.
एक भाषा निवडा आणि खाली सूचीबद्ध अवलंबित्व स्थापित करा. उदाहरणे क्लाउड 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 - पुन्हा प्रयत्न करण्यापूर्वी प्रतिसाद शीर्षलेखात दिलेल्या विलंबाची प्रतीक्षा करा. डीफॉल्ट टोकन-प्रयत्न मर्यादा प्रत्येक रिलेवर 10 प्रति स्त्रोत IP प्रति मिनिट आहे. प्लॅटफॉर्म सेटिंग्ज ही मर्यादा बदलू शकतात.