Delen via

Naslaginformatie over Cloud Partner-portal-API

  • Artikel

Notitie

De Cloud Partner Portal-API's zijn geïntegreerd met en blijven werken in partnercentrum. De overgang introduceert kleine wijzigingen. Controleer de wijzigingen in CPP-API's die in dit document worden vermeld om ervoor te zorgen dat uw code blijft werken na de overgang naar Partnercentrum. CPP-API's mogen alleen worden gebruikt voor bestaande producten die al vóór de overgang naar partnercentrum zijn geïntegreerd; nieuwe producten moeten gebruikmaken van api's voor het indienen van partnercentrums.

Met de REST API's van de Cloud Partner Portal kunnen workloads, aanbiedingen en uitgeversprofielen programmatisch worden opgehaald en bewerkt. De API's maken gebruik van op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) om de juiste machtigingen af te dwingen tijdens de verwerking.

Deze naslaginformatie bevat de technische details voor de REST API's van de Cloud Partner Portal. De nettoladingsvoorbeelden in dit document zijn alleen ter referentie en kunnen worden gewijzigd wanneer er nieuwe functionaliteit wordt toegevoegd.

Vereisten en overwegingen

Voordat u de API's gebruikt, moet u het volgende controleren:

  • Het artikel Vereisten voor meer informatie over het toevoegen van een service-principal aan uw account en het verkrijgen van een Microsoft Entra-toegangstoken voor verificatie.
  • De twee gelijktijdigheidsbeheerstrategieën die beschikbaar zijn voor het aanroepen van deze API's.
  • Andere API-overwegingen, zoals versiebeheer en foutafhandeling.

Wijzigingen in CPP-API's na de migratie naar Partnercentrum

API Beschrijving wijzigen Impact
POST Publish, GoLive, Cancel Voor gemigreerde aanbiedingen heeft de antwoordheader een andere indeling, maar blijft deze op dezelfde manier werken, wat een relatief pad aangeeft om de bewerkingsstatus op te halen. Wanneer u een van de bijbehorende POST-aanvragen voor een aanbieding verzendt, heeft de locatieheader een van de twee indelingen, afhankelijk van de migratiestatus van de aanbieding:
  • Niet-gemigreerde aanbiedingen
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Gemigreerde aanbiedingen
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
GET-bewerking Voor aanbiedingstypen die eerder het veld 'notification-email' in het antwoord ondersteunen, wordt dit veld afgeschaft en niet meer geretourneerd voor gemigreerde aanbiedingen. Voor gemigreerde aanbiedingen verzenden we geen meldingen meer naar de lijst met e-mailberichten die zijn opgegeven in de aanvragen. In plaats daarvan wordt de API-service afgestemd op het e-mailproces voor meldingen in Partnercentrum om e-mailberichten te verzenden. Meldingen worden met name verzonden naar het e-mailadres dat is ingesteld in de sectie Contactgegevens van verkoper van uw accountinstellingen in het Partnercentrum, om u op de hoogte te stellen van de voortgang van de bewerking.

Controleer het e-mailadres dat is ingesteld in de sectie Contactgegevens van verkoper van uw accountinstellingen in partnercentrum om ervoor te zorgen dat de juiste e-mail wordt opgegeven voor meldingen.

Algemene taken

In deze referentie worden API's beschreven voor het uitvoeren van de volgende algemene taken.

Aanbiedingen

Operations

Een app publiceren

Andere taken

Probleemoplossing

API-versies en -updates

Bijwerken Wat is er veranderd?
12-2022 De openbare CPP-API (versie 2017-10-31) wordt nu bijgewerkt om clientId en clientSecret voor Marketo-connector vast te leggen tijdens het configureren van leads van klanten. Tijdens de leadconfiguratie hoeft u het serverId-veld niet in de toekomst op te geven. Deze update voor de API omvat geen versie-updates of wijzigingen die fouten veroorzaken.