أرسل اسم المستخدم والسر الخاصين ببيانات الاعتماد الخاصة بك إلى نقطة نهاية الرمز المميز. لا يحتاج هذا التبادل إلى رمز مميز لحامله. استخدم رمز الوصول الذي تم إرجاعه كرمز مميز لحامل في طلبات REST اللاحقة.
password: يحمل حقل JSON هذا سر بيانات اعتماد واجهة برمجة التطبيقات (API)، وليس كلمة مرور تسجيل الدخول إلى حسابك.
قم بتقديم طلبك الأول
قم بتشغيل المثال محليًا. يطالبك ببيانات الاعتماد الخاصة بك، ويحصل على رمز الوصول ويسرد الصفحة الأولى من الأجهزة. حافظ على خصوصية الرمز المميز. لا تطلب صفحات التوثيق هذه أبدًا بيانات الاعتماد أو تخزنها.
اختر لغة وقم بتثبيت التبعيات المدرجة أدناه. تستخدم الأمثلة عنوان Cloud 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 مصدر في الدقيقة على كل ترحيل. يمكن لإعدادات النظام الأساسي تغيير هذا الحد.