İş Ortağı Merkezi REST API'sinin desteklediği İş Ortağı Merkezi REST ve yanıt üst bilgileri

için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

İş Ortağı Merkezi REST API, aşağıdaki HTTP istek ve yanıt üst bilgilerini destekler. Tüm API çağrıları tüm üst bilgileri kabul etmemektedir.

REST istek başlıkları

İş Ortağı Merkezi REST API'sinde aşağıdaki HTTP isteği üst bilgileri desteklenir.

Üstbilgi	Açıklama	Değer Türü
Authorization:	Gerekli. Bearer <biçimindeki yetkilendirme belirteci>.	dizgi
Accept:	application/jsonistek ve yanıt türünü belirtir.	karakter dizisi
MS-RequestId:	Çağrıyı eşsiz kılan ve idempotens sağlamak için kullanılan tanımlayıcı. Zaman aşımı varsa, yeniden deneme çağrısı aynı değeri içermelidir. Yanıt aldıktan sonra (başarılı veya işlem hatası), değer bir sonraki çağrı için sıfırlanmalıdır.	GUID
MS-CorrelationId:	Aramanın benzersiz tanımlayıcısı, günlüklerde ve ağ izlemelerinde hata giderme için kullanışlıdır. Değer her çağrı için sıfırlanmalıdır. Tüm işlemler bu üst bilgiyi içermelidir. Daha fazla bilgi için Test ve hata ayıklama içindeki bağıntı kimliği bilgilerine bakın.	GUID
MS-Contract-Version:	Gerekli. İstenen API sürümünü belirtir; Bu değer, Senaryoları bölümünde aksi belirtilmedikçe genellikle api-version: v1'dir.	dizgi
If-Match:	Eşzamanlılık denetimi için kullanılır. Bazı API çağrıları, ETag'in If-Match üst bilgisi aracılığıyla geçirilmesini gerektirir. ETag genellikle kaynağın üzerindedir ve bu nedenle en son sürümü almak için GET isteği yapılmasını gerektirir. Daha fazla bilgi için Test ve hata ayıklamaiçindeki ETag bilgilerine bakın.	dizgi
MS-PartnerCenter-Application	Opsiyonel. İş Ortağı Merkezi REST API'sini kullanan uygulamanın adını belirtir.	dizgi
X-Locale:	Opsiyonel. Oranların döndürüldiği dili belirtir. Varsayılan değer en-US. Desteklenen değerlerin listesi için bkz. İş Ortağı Merkezi'nde desteklenen diller ve yerel ayarlar.	dizgi

REST yanıt başlıkları

İş Ortağı Merkezi REST API'si aşağıdaki HTTP yanıt üst bilgilerini döndürebilir.

Üstbilgi	Açıklama	Değer Türü
Accept:	application/jsonistek ve yanıt türünü belirtir.	dizgi
MS-RequestId:	Çağrının idempotansını sağlamak için kullanılan benzersiz tanımlayıcı. Zaman aşımı varsa, yeniden deneme çağrısı aynı değeri içermelidir. Yanıt aldıktan sonra (başarılı veya işlem hatası), değer bir sonraki çağrı için sıfırlanmalıdır.	GUID
MS-CorrelationId:	Çağrı için benzersiz bir tanımlayıcı. Bu değer, hatayı bulmak için günlüklerde ve ağ izlemelerinde sorun gidermede kullanışlıdır. Değer her çağrı için sıfırlanmalıdır. Tüm işlemler bu üst bilgiyi içermelidir.	GUID