Verificatie authentication
Overzicht
De Edge Network Server API behandelt zowel voor authentiek verklaarde als niet voor authentiek verklaarde gegevensinzameling, afhankelijk van de bron van gebeurtenissen en het API inzamelingsdomein.
Voor elk verzoek Server API verifieert de datastream access type instellen. Met deze instelling kunnen klanten een gegevensstroom configureren voor het accepteren van geverifieerde gegevens of van geverifieerde en niet-geverifieerde gegevens. Standaard worden beide typen gegevens geaccepteerd.
Voor details bij het vormen van het gegevenstroomtoegangstype, zie de documentatie over hoe te een gegevensstroom maken en configureren.
Hieronder volgt een overzicht van het gedrag, gebaseerd op de datastream Access Type configuratie en het eindpunt waarop het verzoek wordt ontvangen.
API-aanroepen die afkomstig zijn van een privéserver op server.adobedc.net moet altijd worden geverifieerd.
Vereisten prerequisites
Alvorens u vraag kunt maken aan Server APIvoldoet aan de volgende voorwaarden:
- U hebt een organisatie-account met toegang tot Adobe Experience Platform.
- Je Experience Platform account heeft de
developerenuserrollen ingeschakeld voor het Adobe Experience Platform API-productprofiel. Neem contact op met uw Admin Console beheerder om deze rollen voor uw rekening toe te laten. - Je hebt een Adobe ID. Als je geen Adobe ID hebt, ga dan naar de Adobe Developer Console en maak een nieuwe account.
Referenties verzamelen credentials
Als u aanroepen wilt uitvoeren naar platform-API's, moet u eerst de verificatiezelfstudie. Het voltooien van de autorisatiezelfstudie biedt de waarden voor elk van de vereiste headers in alle Experience Platform API-aanroepen, zoals hieronder wordt getoond:
- Toestemming: houder
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
De middelen in Experience Platform kunnen aan specifieke virtuele zandbakken worden geïsoleerd. In aanvragen voor platform-API's kunt u de naam en id opgeven van de sandbox waarin de bewerking plaatsvindt. Dit zijn optionele parameters.
- x-sandbox-name:
{SANDBOX_NAME}
Alle verzoeken die een nuttige lading (POST, PUT, PATCH) bevatten vereisen een extra media type kopbal:
- Inhoudstype:
application/json
Machtigingen voor schrijven gegevensset configureren dataset-write-permissions
Om dataset te vormen schrijf toestemmingen, ga naar Admin Console, zoekt u het productprofiel dat is gekoppeld aan de API-sleutel en stelt u de volgende machtigingen in:
- In de Sandboxes selecteert u de gegevensstroomsandbox.
- In de Data Management selecteert u de Manage Datasets toestemming.
Problemen met autorisatiefouten oplossen troubleshooting-authorization
EXEG-0500-401Dit foutbericht wordt in een van de volgende situaties weergegeven:
- De
authorizationkoptekstwaarde ontbreekt. - De
authorizationheader value does not include the requiredBearertoken. - De opgegeven machtigingstoken heeft een ongeldige indeling.
- De gegevensstroom vereist authentificatie maar het verzoek mist vereiste kopballen.
EXEG-0501-401Dit foutbericht wordt in een van de volgende situaties weergegeven:
- De API-aanroep ontbreekt
x-user-tokenheader. - De opgegeven gebruikerstoken heeft een ongeldige indeling.
EXEG-0502-401EXEG-0503-401EXEG-0504-401Dit foutbericht wordt in een van de volgende situaties weergegeven:
- Het ontwikkelaarsaccount heeft geen toegang tot de Adobe Experience Platform-productcontext.
- Het bedrijfsaccount heeft nog geen recht op een Adobe Experinece Platform.
EXEG-0505-401acp.foundation IMS-bereik.EXEG-0506-401WRITE toegang tot de sandbox van het Experience Platform waarin de gegevensstroom is gedefinieerd.