İş Ortağı Merkezi REST API'sinin desteklediği İş Ortağı Merkezi REST ve yanıt üst bilgileri
Şunlar 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'sinde aşağıdaki HTTP isteği ve yanıt üst bilgileri desteklenir. Tüm API çağrıları tüm üst bilgileri kabul etmemektedir.
REST isteği üst bilgileri
İş Ortağı Merkezi REST API'sinin desteklediği HTTP isteği üst bilgileri İş Ortağı Merkezi REST API'sinde desteklenir.
| Üst bilgi | Açıklama | Değer Türü |
|---|---|---|
| Yetkilendirme: | Gerekli. Taşıyıcı <belirteci biçimindeki yetkilendirme belirteci>. | Dize |
| Kabul: | İstek ve yanıt türünü ( application/json) belirtir. | Dize |
| MS-RequestId: | Kimlik gücünden emin olmak için kullanılan çağrının benzersiz tanımlayıcısı. 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ğ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 etme ve hata ayıklama konusundaki Bağıntı Kimliği bilgilerine bakın. | GUID |
| MS-Contract-Version: | Gerekli. İstenen API sürümünü belirtir; Senaryolar bölümünde aksi belirtilmedikçe bu değer genellikle api-version: v1 şeklindedir . | Dize |
| 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 gerektirir. Daha fazla bilgi için Test ve hata ayıklama konusundaki ETag bilgilerine bakın. | Dize |
| MS-PartnerCenter-Application | isteğe bağlı. İş Ortağı Merkezi REST API'sini kullanan uygulamanın adını belirtir. | Dize |
| X-Locale: | isteğe bağlı. Oranların döndürüldiği dili belirtir. Varsayılan değer en-US'dir. Desteklenen değerlerin listesi için bkz . İş Ortağı Merkezi tarafından desteklenen diller ve yerel ayarlar. | Dize |
REST yanıt üst bilgileri
İş Ortağı Merkezi REST API'sinde aşağıdaki HTTP yanıt üst bilgileri döndürülebilir:
| Üst bilgi | Açıklama | Değer Türü |
|---|---|---|
| Kabul: | İstek ve yanıt türünü ( application/json) belirtir. | Dize |
| MS-RequestId: | Kimlik gücünden emin olmak için kullanılan çağrının benzersiz tanımlayıcısı. 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ğ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 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 |