Aan de slag
Overzicht overview
Op deze pagina wordt beschreven hoe u Adobe Experience Platform Destination SDK kunt verifiëren en gebruiken. Het omvat instructies op hoe te om de authentificatiegeloofsbrieven van Adobe I/O, een zandbaknaam, en de toestemming van de bestemmings auteurstoegang te verkrijgen.
Terminologie terminology
Deze handleiding gebruikt Experience Platform-specifieke concepten, zoals organisatie en sandboxen. Raadpleeg de verklarende woordenlijst van Experience Platformvoor definities van deze termijnen. Raadpleeg de verklarende woordenlijst van Destination SDKvoor termijnen direct met betrekking tot deze functionaliteit.
Verkrijg vereiste authentificatiegeloofsbrieven obtain-authentication-credentials
Destination SDK gebruikt de Adobe I/Ogateway voor authentificatie. Om API vraag aan Destination SDK eindpunten te maken, moet u bepaalde kopballen in uw API vraag verstrekken. Het werk met het team van Adobe Exchange aan opstellingsauthentificatie voor u aan Adobe Developer Console.
Om vraag aan Destination SDK API eindpunten met succes te maken, volg het de authentificatieleerprogramma van Experience Platform. Begin het leerprogramma van " produceert een API sleutel, organisatie identiteitskaart, en cliënt geheim"stap. Het Adobe Exchange-team zal de vorige stappen voor u afhandelen. Als u de zelfstudie over verificatie voltooit, krijgt u de waarden voor elk van de vereiste headers in Destination SDK API-aanroepen, zoals hieronder wordt getoond:
x-api-key: {API_KEY}, ook wel client-id genoemdx-gw-ims-org-id: {ORG_ID}, ook bekend als organisatie-idAuthorization: Bearer {ACCESS_TOKEN}. Het toegangstoken heeft een vervaltijd van 24 uren, die in milliseconden wordt uitgedrukt, zodat zult u het moeten verfrissen. Om het toegangstoken te verfrissen, herhaal de stappen die in het authentificatieleerprogramma worden geschetst.
Eigendom van bestemming en sandboxen destination-ownership
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Voor aanvragen bij Destination SDK zijn headers vereist met de naam van de sandbox waarin de bewerking plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Het Adobe Exchange-team geeft u de naam van uw sandbox, die u moet gebruiken voor aanroepen naar de eindpunten van de Destination SDK API.
Rolgebaseerde toegangscontrole (RBAC) rbac
Om de Destination SDK API eindpunten te gebruiken die in de verwijzingsdocumentatieworden beschreven, hebt u de Destination Authoring toegangsbeheertoestemming nodig. Het werk met het team van Adobe Exchange om deze toestemming te krijgen die aan u in wordt toegewezen Adobe Admin Console.
Lees voor meer informatie de volgende Experience Platform Access Control-documenten:
Aanvullende overwegingen additional-considerations
- Voor productiviteit/openbare bestemmingen, moeten om het even welke veranderingen die u aan bestemmingsconfiguraties aanbrengt, of u creeert of een bestemmingsconfiguratie uitgeeft, door Adobe worden herzien en worden goedgekeurd. Uw veranderingen worden weerspiegeld in uw bestemmingen slechts nadat het overzicht wordt gedaan. Dit geldt niet voor particuliere bestemmingen die alleen voor u beschikbaar zijn.
- Alleen de gebruikers die tot dezelfde organisatie behoren en toegang hebben tot de sandbox, kunnen de doelconfiguratie bewerken.
Volgende stappen next-steps
Door de stappen in dit artikel uit te voeren, hebt u verificatiegegevens verkregen naar Adobe I/O, een sandboxnaam en de toegangsbeheermachtiging voor het ontwerpen van de bestemming. Vervolgens kunt u een bestemming instellen met Destination SDK.
-
Lees de volgende configuratiegidsen, afhankelijk van uw bestemmingstype:
-
Voor alle verrichtingen, verwijs naar de Authoring API documentatie van de Bestemming.
-
Gebruik de Ontwerpen API van de Bestemming de inzameling van Postmanom uw bestemming te vormen gebruikend Destination SDK API eindpunten. Om met Postman begonnen te worden, zie de stappen voor het invoeren van milieu's en inzamelingenen a videogids voor het creëren van het milieu van Postman.