الانتقال إلى المحتوى الرئيسي
تصادق Infrastructure API في ResQ الطلبات باستخدام JWT من نوع bearer. تستبدل اسم المستخدم وكلمة المرور بتوكن على POST /login، ثم ترسل التوكن كرأس Authorization: Bearer <token> على كل طلب محمي.
تُصدَر اعتمادات المشغّل خارج النطاق من قبل مسؤول ResQ الخاص بك. لا يوجد تدفق تسجيل عام — كل مشغّل مرتبط بمنظمة ومجموعة من نطاقات صلاحيات المهام.

​
التدفق

1

اطلب توكنًا

POST /login مع جسم JSON بالشكل {"username": "...", "password": "..."}.
curl -X POST https://api.resq.software/login \
  -H "Content-Type: application/json" \
  -d '{"username":"مشغّل","password":"REDACTED"}'
2

اقرأ الاستجابة

عند النجاح، تُرجِع API توكن JWT وطابع وقت Unix بالثواني لانتهاء الصلاحية.
{
  "token": "eyJhbGciOi...",
  "expires_at": 1746345600
}
عند الفشل، تتلقى 401 مع جسم AuthError.
{ "error": "Invalid credentials" }
3

أرسل التوكن

أرفق التوكن بكل طلب يستهدف نقطة نهاية محمية.
curl https://api.resq.software/evidence \
  -H "Authorization: Bearer $RESQ_TOKEN"

​
مدى صلاحية التوكن

expires_at هو طابع وقت Unix بالثواني. تعامل معه على أنه المرجع — لا تُحلِّل جسم JWT لاستنتاج انتهاء الصلاحية. ينبغي للعميل المتين:
  1. تخزين التوكن في الذاكرة فقط (لا تخزّنه أبدًا في قرص بنص واضح).
  2. التحديث استباقيًا عندما يتبقى أقل من 60 ثانية.
  3. إعادة المصادقة من الاعتمادات عند 401 Unauthorized.
function isExpired(expiresAt: number, skewSeconds = 60) {
  return Math.floor(Date.now() / 1000) >= expiresAt - skewSeconds;
}

​
تخزين الاعتمادات بأمان

لا تُودِع الاعتمادات أبدًا في التحكم بالإصدار ولا تمررها على سطر الأوامر. استخدم متغيرات البيئة أو مدير الأسرار في منصّتك.
export RESQ_USERNAME="..."
export RESQ_PASSWORD="..."
export RESQ_TOKEN="$(curl -sS -X POST https://api.resq.software/login \
  -H 'Content-Type: application/json' \
  -d "{\"username\":\"$RESQ_USERNAME\",\"password\":\"$RESQ_PASSWORD\"}" \
  | jq -r .token)"

​
التدوير

دوّر اعتمادات المشغّل ربعيًا على الأقل، وفورًا إذا كان من الممكن أن يكون التوكن قد انكشف. يُعالَج الإلغاء على الخادم؛ لا يحتاج العميل سوى إعادة تشغيل تدفق تسجيل الدخول.

​
Coordination API

يقبل Coordination API نفس التوكن للمسارات الإدارية ومسارات الموافقة على المهام (مثلاً، POST /admin/missions/approve). قد تستخدم نقاط نهاية الاستيعاب العامة — دفعات القياس عن بُعد، عمليات الرفع إلى IPFS — توكن خدمة مستقل يصدره مسؤولك. تأكَّد من المخطط الدقيق لنشرك.

​
الأخطاء التي ينبغي معالجتها

الرمزالمعنىما الذي ينبغي فعله
401التوكن مفقود أو منتهي أو غير صالحأعد المصادقة، ثم أعد المحاولة مرة واحدة
403التوكن صالح لكن يفتقر إلى نطاق الصلاحية المطلوباعرضه للمشغّل؛ لا تُعد المحاولة
429طلبات كثيرة جدًاتراجع مع jitter ثم أعد المحاولة
راجع الأخطاء للحصول على الغلاف الكامل ومرجع رموز الحالة.