İş Ortağı Merkezi'nde API erişimini ayarlama

2025-03-20

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

Bu makalede, İş Ortağı Merkezi SDK'sına karşı geliştirmeniz gereken hesaplar açıklanmaktadır. Bu makalede ayrıca için entegrasyon korumalı alan hesabı oluşturma ve entegrasyon korumalı alanında test etme adımları açıklanmaktadır.

Nota

API'lere erişim sağlamak için kiracınız Bulut Çözümü Sağlayıcısı (CSP) kiracısı olmalı ve ayrıca Dolaylı Sağlayıcı veya doğrudan fatura kesen iş ortağı olmalısınız.

Hesap tanımlarını anlama

API'nizi entegre edip test etmenize yardımcı olmak için iş ortağı merkezi iki tür hesabı destekler.

Birincil iş ortağı hesabı

Bu hesap, gerçek müşteriler için gerçek siparişler oluşturduğunuz yerdir. Birincil hesapta oturum açtığınızda İş Ortağı Merkezi SDK'sını veya İş Ortağı Panosu kullanıcı arabirimini kullanarak herhangi bir değişiklik veya işlem yaparsanız, bunlar gerçek müşteriler için resmi siparişler olarak değerlendirilir. Bunlar faturanıza yansıtılır ve bunların ödenmesinden şirketiniz sorumludur.

Entegrasyon sandbox hesabı

Bu hesap, kodunuzu ve kapsamlı olarak dağıtmadan önce İş Ortağı Merkezi API'leriyle tümleştirmesini test etme amaçlıdır. Tümleştirme korumalı alanı hesabında oturum açtığınızda yaptığınız değişiklikler ve işlemler faturanızda görünür, ancak fatura tutarını ödemeniz gerekmez. Fatura pdf'sinde bir yasal uyarı bulunur: "ÖDEMEYİnİZ. BU BİR DENEME FATURASIDIR VE EYLEM GEREKMEZ.

Tümleştirme sandbox hesabı ve birincil hesap bağımsız olarak çalışır. Yönetici hesaplarını, kullanıcı hesaplarını, müşterileri, siparişleri, abonelikleri veya diğer verileri paylaşmaz.
Tümleştirme korumalı alanı, sınırlı sayıda müşteri, sipariş, abonelik, lisans vb. içeren işlemlere destek verir.
Deneme alanı hesapları yalnızca politikaya uygun olarak tümleştirme testleri için kullanılmalıdır.
Varsayılan olarak bir tümleştirme test hesabı mevcut değildir. İş Ortağı Merkezi SDK'sını kullanmayı planlıyorsanız kendiniz oluşturmanız gerekir.

Hesaplarınızı ayarlama

Bu bölümde, Partner Center SDK için birincil iş ortağı hesabı ve entegrasyon korumalı alan hesabının nasıl ayarlanacağı açıklanmaktadır.

Entegrasyon için bir test ortamı oluşturun

Tümleştirme korumalı alanı oluşturmak için Bulut Çözümü Sağlayıcısı (CSP) tümleştirme korumalı alanı hesabı oluşturmaadımlarını izleyin.

API erişimini etkinleştirme

Hesabınız ayarlandıktan sonra, İş Ortağı Merkezi SDK'sını tümleştirme korumalı alanıyla kullanabilmek için API erişimini etkinleştirmeniz gerekir. Hem birincil iş ortağı hesabınız hem de tümleştirme korumalı alanı hesabınız için API'ye erişimi ayrı olarak etkinleştirmeniz gerekir.

Genel yönetici hesabıyla İş Ortağı Merkezi oturum açın ve ardından Ayarlar (dişli simgesi) seçin.
Hesap ayarlarıseçin, ardından Uygulama yönetimi.
Henüz bir uygulamanız yoksa yeni bir web uygulaması ekleyin. Mevcut bir web uygulamanız varsa Anahtar ekle düğmesini seçin.
Bir web uygulaması oluşturuyorsanız, özellikle Anahtarı uygulama kayıt bilgilerini kopyalayın ve güvenli bir yerde saklayın.
İş Ortağı Panosu'ndan çıkış yapın.
Tümleştirme sanal alan hesabınızla tekrar oturum açın. Tümleştirme korumalı alanında API erişimini etkinleştirmek için 2-5 arası adımları yineleyin.

Kod yazma ve test

Tümleştirme korumalı alanında kod yazabilir ve kodu test edebilirsiniz. Microsoft Entra Kimliği ile iş Ortağı Merkezi kimlik doğrulamasını ayarlamak için aşağıdaki bilgilere ihtiyacınız vardır.

Uygulama Kimliği / İstemci Kimliği: Ayarlar (dişli simgesi) içinde Kayıtlı uygulama Uygulama Kimliği olarak listelenmiştir >Hesap ayarları>Uygulama yönetimi.
Anahtar: önceki bölümdeyeni bir web uygulaması oluşturduysanız bu anahtarı kullanın.
Alan Adı: Entegrasyon geliştirme ortamı içindir.

Test edilmiş kodu çalıştırma

Çözümünüzü gerçek müşteri verileriyle kullanmak için entegrasyon sandbox kimlik bilgilerinizi ana İş Ortağı hesap kimlik bilgilerinize geçiş yapmanız gerekir.

Test edilen kodunuzu birincil iş ortağı hesabınızda kullanmaya hazır olduğunuzda bir Microsoft Entra güvenlik belirtecine ihtiyacınız vardır. Bu güvenlik belirteci, İş Ortağı Merkezi uygulamanıza, anahtarınıza ve etki alanınıza dayanır; tümleştirme korumalı alanı uygulamanızın, anahtarınızın ve etki alanınızın yerine.

Birincil İş Ortağı Merkezi kimlik bilgilerinizi kullanarak bir Microsoft Entra güvenlik belirteci almak için İş Ortağı Merkezi kimlik doğrulaması adımlarını izleyin. (Daha önce test ortamınız için Microsoft Entra güvenlik belirteci almak üzere bu adımları izlemiştiniz.)
Kodunuzdaki tümleştirme güvenlik belirtecini birincil iş ortağı hesabınızın yeni güvenlik belirteci ile değiştirin.