Bagikan melalui


Rest Pusat Mitra dan header respons yang didukung oleh REST API Pusat Mitra

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

REST API Pusat Mitra mendukung header permintaan dan respons HTTP berikut. Tidak semua panggilan API menerima semua header.

Header permintaan REST

REST API Pusat Mitra mendukung header permintaan HTTP berikut didukung oleh REST API Pusat Mitra.

Header Deskripsi Jenis Nilai
Otorisasi: Harus diisi. Token otorisasi dalam bentuk token> Pembawa<. string
Menerima: Menentukan jenis permintaan dan respons, aplikasi/json. string
MS-RequestId: Pengidentifikasi unik untuk panggilan, digunakan untuk memastikan id-potency. Jika ada batas waktu, panggilan coba lagi harus menyertakan nilai yang sama. Setelah menerima respons (keberhasilan atau kegagalan bisnis), nilai harus diatur ulang untuk panggilan berikutnya. GUID
MS-CorrelationId: Pengidentifikasi unik untuk panggilan, berguna dalam log dan jejak jaringan untuk memecahkan masalah kesalahan. Nilai harus diatur ulang untuk setiap panggilan. Semua operasi harus menyertakan header ini. Untuk informasi selengkapnya, lihat informasi ID Korelasi di Pengujian dan debug. GUID
MS-Contract-Version: Harus diisi. Menentukan versi API yang diminta; Nilai ini biasanya versi api: v1 kecuali ditentukan lain di bagian Skenario . string
If-Match: Digunakan untuk kontrol konkurensi. Beberapa panggilan API memerlukan passing ETag melalui header If-Match. ETag biasanya ada di sumber daya dan oleh karena itu, memerlukan GET-ting yang terbaru. Untuk informasi selengkapnya, lihat informasi ETag di Uji dan debug. string
MS-PartnerCenter-Application Opsional. Menentukan nama aplikasi yang menggunakan REST API Pusat Mitra. string
X-Locale: Opsional. Menentukan bahasa tempat tarif dikembalikan. Defaultnya adalah en-US. Untuk daftar nilai yang didukung, lihat Bahasa dan lokal yang didukung Pusat Mitra. string

Header respons REST

REST API Pusat Mitra mungkin mengembalikan header respons HTTP berikut:

Header Deskripsi Jenis Nilai
Menerima: Menentukan jenis permintaan dan respons, aplikasi/json. string
MS-RequestId: Pengidentifikasi unik untuk panggilan, digunakan untuk memastikan id-potency. Jika ada batas waktu, panggilan coba lagi harus menyertakan nilai yang sama. Setelah menerima respons (keberhasilan atau kegagalan bisnis), nilai harus diatur ulang untuk panggilan berikutnya. GUID
MS-CorrelationId: Pengidentifikasi unik untuk panggilan. Nilai ini berguna untuk memecahkan masalah log dan jejak jaringan untuk menemukan kesalahan. Nilai harus diatur ulang untuk setiap panggilan. Semua operasi harus menyertakan header ini. GUID