ابنِ على أبسكيرا

أنشئ مفتاحاً

ينشئ مشرف الأكاديمية المفتاح من الإدارة ← المطورون ← مفاتيح الواجهة. ابدأ بمفتاح تجريبي وبالصلاحيات اللازمة فقط.

المصادقة

أرسل المفتاح كرمز Bearer مع كل طلب عبر HTTPS.

curl https://ops.135-225-106-2.sslip.io/api/v1/users?limit=5 \
  -H "Authorization: Bearer upk_test_…"

التصفح بين الصفحات

تُرجع القوائم حتى 100 عنصر مع nextCursor؛ أعده في المعامل cursor حتى يصبح فارغاً.

{ "data": [ … ], "nextCursor": "c_8f2…" }
→ ?cursor=c_8f2…&limit=100

معالجة الأخطاء

تستخدم الأخطاء رموز HTTP مع error.code ثابت، وتُرجع أخطاء التحقق الرمز 422 مع تفاصيل الحقول.

{ "error": { "code": "INSUFFICIENT_SCOPE",
  "message": "…" } }

احترم حدود الطلبات

لكل مفتاح حد في الدقيقة. راقب X-RateLimit-Remaining وتمهّل عند 429 وفق Retry-After.

الانتقال للإنتاج

اطلب مفاتيح إنتاج بصلاحيات حساسة يعتمدها مشرف ثانٍ، ودوّر الأسرار مع فترة سماح.