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

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi

Aşağıdaki HTTP isteği ve yanıt üst bilgileri İş Ortağı Merkezi REST API'sinde desteklenir. Tüm API çağrıları tüm üst bilgileri kabul etmemektedir.

REST isteği üst bilgileri

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

Üst bilgi Description Değer Türü
Yetkilendirme: Gereklidir. Taşıyıcı <belirteci biçimindeki yetkilendirme belirteci>. string
Kabul: İstek ve yanıt türünü belirtir, "application/json". string
MS-RequestId: Kimlik gücünden emin olmak için kullanılan çağrı için benzersiz bir 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ş hatası), değerin bir sonraki çağrı için sıfırlanması gerekir. GUID
MS-CorrelationId: Arama için benzersiz bir tanımlayıcıdır ve 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 konusundaki Bağıntı Kimliği bilgilerine bakın. GUID
MS-Contract-Version: Gereklidir. İstenen API sürümünü belirtir; genellikle api-version: Senaryolar bölümünde aksi belirtilmedikçe v1. string
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 kaynaktadır ve bu nedenle en son GET-ting'i gerektirir. Daha fazla bilgi için Test ve hata ayıklama konusundaki ETag bilgilerine bakın. string
MS-PartnerCenter-Application İsteğe bağlı. İş Ortağı Merkezi REST API'sini kullanan uygulamanın adını belirtir. string
X Yerel Ayarı: İsteğe bağlı. Oranların döndürüldiği dili belirtir. Varsayılan değer "en-US" şeklindedir. Desteklenen değerlerin listesi için bkz. İş Ortağı Merkezi tarafından desteklenen diller ve yerel ayarlar. string

REST yanıt üst bilgileri

aşağıdaki HTTP yanıt üst bilgileri İş Ortağı Merkezi REST API'si tarafından döndürülebilir.

Üst bilgi Description Değer Türü
Kabul: İstek ve yanıt türünü belirtir, "application/json". string
MS-RequestId: Kimlik gücünden emin olmak için kullanılan çağrı için benzersiz bir 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ş hatası), değerin bir sonraki çağrı için sıfırlanması gerekir. 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 gidermek 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. GUID