உங்கள் நற்சான்றிதழின் பயனர்பெயர் மற்றும் ரகசியத்தை டோக்கன் எண்ட் பாயிண்டிற்கு அனுப்பவும். இந்த பரிமாற்றத்திற்கு ஒரு தாங்கி டோக்கன் தேவையில்லை. திரும்பிய அணுகல் டோக்கனை அடுத்தடுத்த 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 ஆகும். இயங்குதள அமைப்புகள் இந்த வரம்பை மாற்றலாம்.