الطلب
- Content-Type: application/json
- أرسل عمليات كتابة JSON مع Content-Type: application/json.
- data · meta
- تحتوي الاستجابات الناجحة على data وmeta؛ وتتضمن استجابات المجموعات معلومات الترقيم أيضًا.
- error.code · error.message
- تحتوي الأخطاء على error.code وerror.message ومعلومات الحقول عند انطباقها.
أنواع البيانات
- كون الحقل مطلوبًا وإمكانية احتوائه على null خاصيتان مستقلتان.
- قد يحتوي حقل مطلوب على null إذا سمح مخططه بذلك.
- حافظ على أنواع JSON المنطقية والأعداد الصحيحة والسلاسل النصية وnull دون تحويل تلقائي.
- المبالغ المالية سلاسل عشرية؛ لا تحسب الأسعار باستخدام الفاصلة العائمة الثنائية.
64-bit · expected_version
- تستخدم بعض إصدارات التحكم في التعديلات المتزامنة أعدادًا صحيحة موقعة بطول 64 بت.
- يجب على عميل JavaScript معالجة JSON دون فقد الدقة للقيم الأكبر من Number.MAX_SAFE_INTEGER وإرسال التمثيل الصحيح الأصلي.
- لا تقرّب رقم الإصدار ولا تحوّله إلى سلسلة JSON.
الترويسات
Cache-Controlسلسلة نصيةاختياريسياسة التخزين المؤقت للاستجابة.
const:"no-store"X-Correlation-IDسلسلة نصيةاختياريمعرّف يستخدم لتتبع طلب HTTP هذا.
WWW-Authenticateسلسلة نصيةاختيارينظام المصادقة الذي يطلبه الخادم.
Allowسلسلة نصيةاختياريطرق HTTP التي يدعمها هذا المورد.
Retry-Afterعدد صحيحاختياريالحد الأدنى للانتظار قبل إعادة المحاولة، بالثواني.
minimum:0Locationسلسلة نصيةاختياريعنوان URL نسبي للمورد الذي تم إنشاؤه.