واجهة البرمجة
واجهة البرمجة
كيف تستدعي واجهة امتثال البرمجية من أنظمتك.
العنوان
كل الطلبات إلى https://api.aisc.sa/v1، عبر HTTPS فقط.
الدخول
- أرسل البريد الإلكتروني وكلمة المرور إلى
POST /v1/auth/login. - يعود
access_token، صالحًا قرابة ساعة (expires_inبالثواني). - أرسله مع كل طلب في الترويسة
Authorization: Bearer <access_token>.
إذا كنت تدخل بحساب Google، فعيّن لحسابك كلمة مرور أولًا من «نسيت كلمة المرور».
الأخطاء
أخطاء الدخول والتسجيل تحمل رمزًا ثابتًا في error_code؛ ابنِ عليه برنامجك، لا على نص الرسالة. الرمز 429 يعني طلبات كثيرة: انتظر عدد الثواني في retry_after_seconds ثم أعد المحاولة.
الثبات
لا يتغيّر وصف الواجهة بما يكسر طلبًا قائمًا، كحذف مسار أو حقل أو جعل حقل اختياري إلزاميًا، إلا بإعلان مسبق. يتحقق من ذلك فحص آلي على كل تغيير.
صفحات المرجع
صفحات الأقسام بالإنجليزية لأن وصف الواجهة مكتوب بها، وتُبنى منه عند كل نشر. التجربة المباشرة من هذه الصفحات غير متاحة بعد.