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 de Adobe I/O, een zandbaknaam, en de toestemming van de bestemmings auteurstoegang te verkrijgen.
Terminologie terminology
Deze gids gebruikt Platform-specifieke concepten, zoals organisatie en zandbakken. Raadpleeg de verklarende woordenlijst van het Experience Platformvoor definities van deze termijnen. Raadpleeg de verklarende woordenlijst van de 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 de 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 het Experience Platform. Begin het leerprogramma van " produceert een API sleutel, organisatie identiteitskaart, en cliënt geheim"stap. Het team van de Adobe Exchange zal de vorige stappen voor u behandelen. Het voltooien van de autorisatiezelfstudie biedt 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. Verzoeken om Destination SDK vereisen kopballen die de naam van de zandbak specificeren de verrichting in plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Het team van de Adobe Exchange voorziet u van uw zandbaknaam, die u in vraag aan de Destination SDK API eindpunten moet gebruiken.
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 de Adobe Exchange om deze toestemming te krijgen die aan u in wordt toegewezen Adobe Admin Console.
Lees voor meer informatie de volgende documenten van het Toegangsbeheer van het Experience Platform:
Aanvullende overwegingen additional-considerations
- Voor geproduceerde/openbare bestemmingen, om het even welke veranderingen die u aan bestemmingsconfiguraties aanbrengt, of u creeert of een bestemmingsconfiguratie uitgeeft, moet 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 te volgen, hebt u authentificatiegeloofsbrieven aan Adobe I/O, een zandbaknaam, en de toestemming van de bestemmings authoring toegangscontrole verkregen. Vervolgens kunt u een bestemming instellen met behulp van Destination SDK.
-
Lees de volgende configuratiegidsen, afhankelijk van uw bestemmingstype:
-
Voor alle verrichtingen, verwijs naar de Authoring API documentatie van de Bestemming.
-
Gebruik de Authoring API van de Bestemming de inzameling van Postmanom uw bestemming te vormen gebruikend de 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.