واجهة البرمجة
المصادقة
صادق على واجهة برمجة تطبيقات ماندافو بمفتاح مساحة عمل، واسكب منه اعتمادات وكيل محددة النطاق.
مفاتيح مساحة العمل
الاستدعاءات الإدارية — إنشاء الهويات، وكتابة السياسات، وإصدار الاعتمادات — تُصادَق بمفتاح مساحة عمل. أنشئ واحدًا في الإعدادات وأرسله كرمز حامل في رأس Authorization.
مفاتيح مساحة العمل مخصصة لخلفيتك فقط. لا تصل أبدًا إلى وكيل؛ الوكلاء يتصرفون بالاعتمادات قصيرة الأجل التي تسكها لهم.
عنوان URL الأساسي وترقيم الإصدارات
كل الطلبات تذهب إلى https://api.mandavo.com وتُرقَّم بإصدارات حسب بادئة المسار، بدءًا من /v1. التغييرات الجذرية تُطلَق تحت بادئة جديدة؛ التغييرات الإضافية لا تفعل ذلك.
الطلبات والاستجابات بصيغة JSON. أرسل Content-Type: application/json مع أي طلب يحتوي على محتوى.
اعتمادات الوكيل
لتتيح لوكيل التصرف، استبدل مفتاح مساحة عمل باعتماد محدد النطاق عبر محرك الإصدار، ثم سلّم فقط ذلك الرمز قصير الأجل للوكيل. يحمل الرمز الهوية، والنطاق، وانتهاء الصلاحية.
عامل اعتمادات الوكيل كمهمة واحدة وفي الذاكرة. لا تحتفظ بها؛ اطلب واحدة جديدة للمهمة التالية.
الأخطاء
تستخدم واجهة البرمجة رموز حالة HTTP القياسية. 401 يعني أن المفتاح مفقود أو غير صالح، و403 يعني أن الإجراء خارج نطاق المستدعي أو مرفوض بواسطة السياسة، و429 يعني أنك محدود بمعدل الطلبات. أجسام الأخطاء تتضمن رمزًا قابلًا للقراءة الآلية ورسالة قابلة للقراءة البشرية.