Bulut İş Ortağı Portalı API Başvurusu
Not
Bulut İş Ortağı Portalı API'leri ile tümleşiktir ve İş Ortağı Merkezi'nde çalışmaya devam edecektir. Geçiş küçük değişiklikler sağlar. İş Ortağı Merkezi'ne geçiş yaptıktan sonra kodunuzun çalışmaya devam ettiğinden emin olmak için bu belgede listelenen CPP API'lerinde Yapılan Değişiklikler'i gözden geçirin. CPP API'leri yalnızca İş Ortağı Merkezi'ne geçiş öncesinde zaten tümleştirilmiş olan mevcut ürünler için kullanılmalıdır; yeni ürünler İş Ortağı Merkezi gönderim API'lerini kullanmalıdır.
Bulut İş Ortağı Portalı REST API'leri, iş yüklerinin, tekliflerin ve yayımcı profillerinin program aracılığıyla alınmasına ve değiştirilmesine olanak sağlar. API'ler, işleme zamanında doğru izinleri zorunlu kılmak için Azure rol tabanlı erişim denetimini (Azure RBAC) kullanır.
Bu başvuru, Bulut İş Ortağı Portalı REST API'leri için teknik ayrıntıları sağlar. Bu belgedeki yük örnekleri yalnızca başvuru amaçlıdır ve yeni işlevler eklendikçe değiştirilebilir.
Önkoşullar ve dikkat edilmesi gerekenler
API'leri kullanmadan önce şunları gözden geçirmelisiniz:
- Hesabınıza hizmet sorumlusu eklemeyi ve kimlik doğrulaması için Microsoft Entra erişim belirtecini almayı öğrenmek için Önkoşullar makalesi.
- Bu API'leri çağırmak için kullanılabilen iki eşzamanlılık denetimi stratejisi.
- Sürüm oluşturma ve hata işleme gibi diğer API konuları.
İş Ortağı Merkezi'ne geçiş sonrasında CPP API'lerine yapılan değişiklikler
API | Açıklamayı değiştir | Etki |
---|---|---|
POST Yayımlama, GoLive, İptal | Geçirilen teklifler için yanıt üst bilgisi farklı bir biçime sahiptir, ancak işlem durumunu almak için göreli bir yol belirterek aynı şekilde çalışmaya devam eder. | Teklif için ilgili POST isteklerinden herhangi birini gönderirken, Teklifin geçiş durumuna bağlı olarak Konum üst bilgisi iki biçimden birine sahiptir:
|
GET İşlemi | Yanıtta daha önce 'notification-email' alanını destekleyen teklif türleri için bu alan kullanım dışı bırakılacak ve geçirilen teklifler için artık döndürülmeyecek. | Geçirilen teklifler için artık isteklerde belirtilen e-posta listesine bildirim göndermeyeceğiz. Bunun yerine API hizmeti, e-posta göndermek için İş Ortağı Merkezi'ndeki bildirim e-posta işlemiyle hizalanır. Özellikle, işlem ilerleme durumunu bildirmek için İş Ortağı Merkezi'ndeki Hesap ayarlarınızın Satıcı iletişim bilgileri bölümünde ayarlanan e-posta adresine bildirimler gönderilir. Bildirimler için doğru e-postanın sağlandığından emin olmak için İş Ortağı Merkezi'ndeki Hesap ayarlarınızın Satıcı iletişim bilgileri bölümünde ayarlanan e-posta adresini gözden geçirin. |
Genel görevler
Bu başvuru, aşağıdaki yaygın görevleri gerçekleştirmek için API'lerin ayrıntılarını içerir.
Teklifler
Operations
Uygulama yayımlama
Diğer görevler
Sorun giderme
API sürümleri ve güncelleştirmeleri
Güncelleştir | Neler değişti? |
---|---|
12-2022 | CPP genel API'si (sürüm 2017-10-31), müşteri müşteri adaylarını yapılandırırken clientId ve clientSecret for Marketo bağlayıcısını yakalayacak şekilde güncelleştirildi. Müşteri adayı yapılandırması sırasında, bundan sonra serverId alanını sağlamanız gerekmez. API'ye yapılan bu güncelleştirme, herhangi bir sürüm güncelleştirmesi veya hataya neden olan değişiklikleri içermez. |