Denetim Masası Satıcısı olarak müşteri onayı alma
Denetim Masası Satıcısı (CPV) olarak REST API'lerini kullanarak CSP müşterilerinizden kiracılarına izin almak için onay alabilir ve kaldırabilirsiniz.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Not
Hız sınırı, her applicationId için saniyede 50 istek (RPS) (CPV iş ortağının Uygulama Kimliği) olur.
Onay alma
URI parametreleri
| Veri Akışı Adı | İçinde | Zorunlu | Türü | Açıklama |
|---|---|---|---|---|
| customer_id | yol | Doğru | Dize | İş Ortağı Merkezi'nde oluşturulan müşterinin kimliği |
İstek üst bilgisi
Medya türleri: application/json
| Veri Akışı Adı | Zorunlu | Türü | Açıklama |
|---|---|---|---|
| Yetkilendirme | Doğru | Dize | hedef kitle için Erişim Belirteci https://api.partnercenter.microsoft.com |
| Kabul Et | Doğru | Dize | Kabul edilebilir içerik türü; yaygın olarak kabul edilen tür uygulaması/json |
| ms-correlationid | Dize | İstekleri dahili olarak izlemek için kullanılır. Ms-correlationid sağlanmadıysa, sunucu her istek için yeni bir tane oluşturur | |
| ms-requestid | Dize | İsteklerin eşzamanlılığı için kullanılır. Bir ms-requestid sağlanmazsa, sunucu her istek için yeni bir tane oluşturur |
Request body
Medya türleri: application/json
| Adı | Tür | Açıklama |
|---|---|---|
| applicationId | Dize | CPV iş ortağının Uygulama Kimliği |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Kiracılarındaki müşterilerinize erişim elde etmek için uygulama izinlerinin listesi |
Yanıtlar
| Adı | Tür | Açıklama |
|---|---|---|
| 200 Tamam | İstek başarılı oldu. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 201 Oluşturuldu | Uygulama onayı oluşturulur. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 400 Hatalı İstek | Eksik veya geçersiz giriş vardı. Yanıt gövdesi hata ayrıntılarını içerir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 401 Yetkisiz | İsteğin kimliği doğrulanmamış. İstemcinin geçerli hedef kitle için geçerli bir erişim belirteci geçirmesi gerekir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 403 Yasak | İsteğin kimliği doğrulandı, ancak çağıranın çağırma hakkı olmadığından reddedildi. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 404 Bulunamadı | Kaynak bulunamadı veya verilen giriş parametreleriyle kullanılamıyor. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 500 İç Sunucu Hatası | İş ortağı API hizmeti veya bağımlılıklarından biri isteği yerine getiremedi. Arayanlar isteği yeniden deneyebilir. Medya Türleri: application/json, application/xml, text/xml, text/json |
Tanımlar
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Adı | Tür | Açıklama |
|---|---|---|
| enterpriseApplicationId | Dize | Erişim kazanan kaynağın GUID gösterimi |
| kapsam | Dize | Erişim kazanmak için kapsamın virgülle ayrılmış değerleri |
Onayı kaldırma
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Not
Hız sınırı, her applicationId için saniyede 50 istek (RPS) (CPV iş ortağının Uygulama Kimliği) olur.
URI parametreleri
| Veri Akışı Adı | İçinde | Zorunlu | Türü | Açıklama |
|---|---|---|---|---|
| customer_id | yol | Doğru | Dize | İş Ortağı Merkezi'nde oluşturulan müşterinin kimliği |
| Application_id | yol | Doğru | Dize | CPV uygulamanızın kimliği |
İstek üst bilgisi
Medya türleri: application/json
| Veri Akışı Adı | Zorunlu | Türü | Açıklama |
|---|---|---|---|
| Yetkilendirme | Doğru | Dize | hedef kitle için erişim belirteci https://api.partnercenter.microsoft.com |
| Kabul Et | Doğru | Dize | Kabul edilebilir içerik türü, genellikle application/json türü |
| ms-correlationid | Dize | İstekleri dahili olarak izlemek için kullanılır. ms-correlationid sağlanmadıysa, sunucu her istek için yeni bir tane oluşturur |
|
| ms-requestid | Dize | İsteklerin eşzamanlılığı için kullanılır. Bir ms-requestid sağlanmazsa, sunucu her istek için yeni bir tane oluşturur |
Yanıtlar
| Adı | Tür | Açıklama |
|---|---|---|
| 200 Tamam | İstek başarılı oldu. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 201 Oluşturuldu | Uygulama onayı silinir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 400 Hatalı İstek | Eksik veya geçersiz giriş vardı. Yanıt gövdesi hata ayrıntılarını içerir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 401 Yetkisiz | İsteğin kimliği doğrulanmamış. İstemcinin geçerli hedef kitle için geçerli bir erişim belirteci geçirmesi gerekir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 403 Yasak | İsteğin kimliği doğrulandı, ancak çağıranın çağırma hakkı olmadığından reddedildi. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 404 Bulunamadı | Kaynak bulunamadı veya verilen giriş parametreleriyle kullanılamıyor. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 500 İç Sunucu Hatası | İş ortağı API hizmeti veya bağımlılıklarından biri isteği yerine getiremedi. Arayanlar isteği yeniden deneyebilir. Medya Türleri: application/json, application/xml, text/xml, text/json |