Partner Center REST dan header respons yang didukung oleh Partner Center REST API
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 HTTP REST
REST API Pusat Mitra mendukung header permintaan HTTP berikut.
| Header | Deskripsi | Jenis Nilai |
|---|---|---|
Authorization: |
Diperlukan. Token otorisasi dalam bentuk Bearer <token>. | tali |
Accept: |
Menentukan jenis permintaan dan respons, aplikasi/json. | string karakter |
MS-RequestId: |
Pengidentifikasi unik untuk panggilan, digunakan untuk memastikan sifat idempoten. 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 Uji dan debug. | GUID |
MS-Contract-Version: |
Diperlukan. Menentukan versi API yang diminta; nilai ini biasanya api-version: v1 kecuali ditentukan lain di bagian Skenario. | tali |
If-Match: |
Digunakan untuk kontrol konkurensi. Beberapa panggilan API memerlukan pengiriman ETag melalui header If-Match. ETag biasanya ada di sumber daya dan oleh karena itu, memerlukan pengambilan data terbaru menggunakan metode GET. Untuk informasi lebih lanjut, lihat informasi ETag di Uji dan debug. | string |
MS-PartnerCenter-Application |
Fakultatif. Menentukan nama aplikasi yang menggunakan REST API dari Pusat Mitra. | tali |
X-Locale: |
Fakultatif. Menentukan bahasa tempat tarif dikembalikan. Defaultnya adalah en-US. Untuk daftar nilai yang didukung, lihat bahasa dan lokal yang didukung Pusat Mitra. | rangkaian karakter |
Header respons REST
API REST dari Pusat Mitra mungkin mengembalikan header respons HTTP berikut.
| Header | Deskripsi | Jenis Nilai |
|---|---|---|
Accept: |
Menentukan jenis permintaan dan respons, aplikasi/json. | tali |
MS-RequestId: |
Panggilan memiliki pengidentifikasi unik yang digunakan untuk memastikan idempotensi. 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: |
ID 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 |