الرؤوس
تتيح هذه المقالة ارتباطات إلى صفحات مرجعية للعناوين المستخدمة مع واجهة برمجة تطبيقات REST الخاصة بـ App Configuration REST API.
عناوين الطلب
يوضح الجدول التالي عناوين الطلب الشائعة المستخدمة في Azure App Configuration.
| الرأس | الوصف | مثال |
|---|---|---|
| التخويل | يستخدم لمصادقة طلب للخدمة. راجِع القسم 14.8 | Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature> |
| قبول | يُعلم الخادم بنوع الوسائط الذي سيقبله العميل في استجابة HTTP. راجع القسم 14.1 | Accept: application/vnd.microsoft.appconfig.kv+json; |
| Accept-Datetime | يطلب من الخادم إعادة محتواه كتمثيل لحالته السابقة. تعد قيمة هذا العنوان هي التاريخ والوقت المطلوبان لتلك الحالة. راجع RFC 7089 | Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT |
| نوع المحتوى | يشتمل على نوع الوسائط للمحتوى داخل نص طلب HTTP. راجع القسم 14.17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
| التاريخ | تاريخ ووقت إصدار طلب HTTP. يُستخدم هذا العنوان في مصادقة التعليمة البرمجية لمصادقة الرسالة المستندة إلى التجزئة. راجع القسم 14.18 | Date: Fri, 11 May 2018 18:48:36 GMT |
| المضيف | تحديد المستأجر الذي أُصدر الطلب من أجله. يُستخدم هذا العنوان في مصادقة التعليمة البرمجية لمصادقة الرسالة المستندة إلى التجزئة. راجع القسم 14.23 | Host: contoso.azconfig.io |
| في حالة التطابق | يستخدم لجعل طلب HTTP شرطيًا. يجب أن ينجح هذا الطلب فقط في حالة تطابق ETag للمورد المستهدف مع قيمة هذا العنوان. القيمة '*' تطابق أي ETag. راجع القسم 14.24 | If-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
| إذا لم يكن هناك تطابق | يستخدم لجعل طلب HTTP شرطيًا. ينبغي أن ينجح هذا الطلب فقط إذا كان ETag للمورد المستهدف لا يتطابق مع قيمة هذا العنوان. القيمة '*' تطابق أي ETag. راجع القسم 14.26 | If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903" |
| Sync-Token | يُستخدم لتمكين التناسق في الوقت الفعلي أثناء سلسلة من الطلبات. | Sync-Token: jtqGc1I4=MDoyOA==;sn=28 |
| x-ms-client-request-id | معرّف فريد يقدمه العميل يُستخدم لتعقب الطلب ذهابًا وإيابًا. | x-ms-client-request-id: 00000000-0000-0000-0000-000000000000 |
| x-ms-content-sha256 | تجزئة sha256 خاصة بنص طلب HTTP. يُستخدم هذا العنوان في مصادقة التعليمة البرمجية لمصادقة الرسالة المستندة إلى التجزئة. | x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU= |
| x-ms-date | يمكن تعيين هذا العنوان واستخدامه بدلا من Date العنوان في حالة تعذر الوصول إلى عنوان التاريخ. يُستخدم هذا العنوان في مصادقة التعليمة البرمجية لمصادقة الرسالة المستندة إلى التجزئة. |
x-ms-date: Fri, 11 May 2018 18:48:36 GMT |
| x-ms-return-client-request-id | يستخدم بالتزامن مع العنوان x-ms-client-request-id. إذا كانت قيمة هذا العنوان «صحيحة»، فسيتم توجيه الخادم لإعادة قيمة عنوان الطلب x-ms-client-request-id. |
x-ms-return-client-request-id: true |
عناوين الاستجابة
يمكن أن يتضمن الخادم عناوين HTTP التالية في استجاباته.
| الرأس | الوصف | مثال |
|---|---|---|
| نوع المحتوى | يحتوي على نوع الوسائط للمحتوى داخل نص استجابة HTTP. راجع القسم 14.17 | Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8; |
| ETag | رمز مميز مبهم يمثل حالة مورد معين. يمكن استخدامه في العمليات الشرطية. راجع القسم 14.19 | ETag: "4f6dd610dd5e4deebc7fbaef685fb903" |
| تاريخ التعديل الأخير | يصف وقت آخر تعديل للمورد المطلوب. مُعد بصيغة HTTP-Date. راجع القسم 14.29 | Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT |
| الرابط | يوفر روابط لمصادر مرتبطة بالاستجابة. يُستخدم هذا العنوان للترحيل باستخدام الارتباط التالي. راجع RFC 5988 | Link: </kv?after={token}>; rel="next" |
| Memento-Datetime | يشير إلى أن المحتوى المدرج في الاستجابة يمثل حالة سابقة. تعتبر القيمة الخاصة بهذا العنوان هي التاريخ والوقت المطلوبان لتلك الحالة. راجع RFC 7089 | Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT |
| retry-after-ms | يتيح فترة مقترحة (بالمللي ثانية) لانتظار العميل قبل إعادة محاولة طلب فاشل. | retry-after-ms: 10 |
| x-ms-request-id | معرف فريد تم إنشاؤه عن طريق الخادم المستخدم لتعقب الطلب داخل الخدمة. | x-ms-request-id: 00000000-0000-0000-0000-000000000000 |
| WWW-Authenticate | يستخدم لتحدي العملاء للمصادقة وتوفير سبب لفشل محاولة المصادقة. راجع القسم 14.47 | WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature" |