Experience Platform Handleiding Veelgestelde vragen en problemen oplossen

Dit document bevat antwoorden op veelgestelde vragen over Adobe Experience Platform en een gids voor probleemoplossing op hoog niveau voor algemene fouten die kunnen worden aangetroffen in elke Experience Platform -API. Voor het oplossen van problemengidsen op de individuele Experience Platform diensten, zie de ​ folder van het de dienstoplossen van problemen ​ hieronder.

Veelgestelde vragen faq

Hieronder volgt een lijst met antwoorden op veelgestelde vragen over Adobe Experience Platform.

Wat zijn Experience Platform API's? what-are-experience-platform-apis

Experience Platform biedt meerdere RESTful-API's die HTTP-aanvragen gebruiken om toegang te krijgen tot Experience Platform -bronnen. Deze service-API's stellen elk meerdere eindpunten beschikbaar en stellen u in staat bewerkingen uit te voeren om bronnen (GET), lookup (GET), edit (PUT en/of PATCH) en delete (DELETE) weer te geven. Voor meer informatie over specifieke eindpunten en verrichtingen beschikbaar voor elke dienst, te zien gelieve de ​ documentatie van de Verwijzing API ​ op Adobe I/O.

Hoe kan ik een API-aanvraag opmaken? how-do-i-format-an-api-request

De aanvraagindelingen variëren afhankelijk van de Experience Platform API die wordt gebruikt. De beste manier om te leren hoe te om uw API vraag te structureren is door naast de voorbeelden te volgen die in de documentatie voor de bepaalde Experience Platform dienst worden verstrekt u gebruikt.

Voor meer informatie bij het formatteren van API verzoeken, gelieve te bezoeken Experience Platform API begonnen gids ​ lezend steekproefAPI vraag ​ sectie.

Wat is mijn organisatie? what-is-my-ims-organization

Een organisatie is een Adobe-representatie van een klant. Alle in licentie gegeven Adobe-oplossingen zijn geïntegreerd met deze klantenorganisatie. Wanneer een organisatie Experience Platform mag gebruiken, kan zij toegang toewijzen aan ontwikkelaars. De organisatie-id (x-gw-ims-org-id) vertegenwoordigt de organisatie waarvoor een API-aanroep moet worden uitgevoerd en is daarom vereist als een header in alle API-aanvragen. Deze identiteitskaart kan door ​ Adobe Developer Console ​ worden gevonden: in het 3} lusje van de Integraties {, navigeer aan de sectie van het Overzicht voor om het even welke bijzondere integratie om identiteitskaart onder de Geloofsbrieven van de Cliënt te vinden. Voor een geleidelijke analyse van hoe te in Experience Platform voor authentiek te verklaren, zie het ​ authentificatieleerprogramma ​.

Waar kan ik mijn API-sleutel vinden? where-can-i-find-my-api-key

Een API-sleutel is vereist als een header in alle API-aanvragen. Het kan door ​ Adobe Developer Console ​ worden gevonden. Binnen de console, op het lusje van de Integraties, navigeer aan de sectie van het Overzicht voor een specifieke integratie en u zult de sleutel onder Credentials van de Cliënt vinden. Voor een geleidelijke analyse van hoe te om aan Experience Platform voor authentiek te verklaren, zie het ​ authentificatieleerprogramma ​.

Hoe krijg ik een toegangstoken? how-do-i-get-an-access-token

Toegangstempens zijn vereist in de machtigingheader van alle API-aanroepen. Ze kunnen worden gegenereerd met behulp van een CURL-opdracht, op voorwaarde dat u toegang hebt tot een integratie voor een organisatie. Toegangstokens zijn slechts geldig gedurende 24 uur, waarna een nieuw teken moet worden geproduceerd om verder te gebruiken API. Voor details bij het produceren van toegangstokens, zie het ​ authentificatieleerprogramma ​.

Hoe gebruik ik queryparameters? how-do-i-user-query-parameters

Sommige API-eindpunten van Experience Platform accepteren queryparameters om specifieke informatie te zoeken en de resultaten in de reactie te filteren. De parameters van de vraag worden toegevoegd aan verzoekwegen met een vraagteken (?) symbool, dat door één of meerdere vraagparameters wordt gevolgd gebruikend het formaat paramName=paramValue. Wanneer het combineren van veelvoudige parameters in één enkele vraag, moet u ampersand (&) gebruiken om individuele parameters te scheiden. Het volgende voorbeeld toont aan hoe een verzoek dat veelvoudige vraagparameters gebruikt in de documentatie wordt vertegenwoordigd.

Voorbeelden van veelgebruikte queryparameters zijn:

GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created

Voor gedetailleerde informatie over welke vraagparameters voor de specifieke dienst of een eindpunt beschikbaar zijn, te herzien gelieve de dienst-specifieke documentatie.

Hoe kan ik een JSON-veld aangeven dat moet worden bijgewerkt in een PATCH-aanvraag? how-do-i-indicate-a-json-field-to-update-in-a-patch-request

Vele verrichtingen van PATCH in Experience Platform APIs gebruiken ​ JSON ​ koorden van de Aanwijzer om op eigenschappen te wijzen JSON om bij te werken. Deze zijn typisch inbegrepen in verzoeklading gebruikend ​ JSON formaat van het Reparatie ​. Zie de ​ API grondbeginselen gids ​ voor gedetailleerde informatie over vereiste syntaxis voor deze technologieën.

Kan ik Postman gebruiken om oproepen te doen naar Experience Platform API's? how-do-i-use-postman-to-make-calls-to-platform-apis

​ Postman ​ is een nuttig hulpmiddel om vraag aan RESTful APIs te visualiseren. De ​ Experience Platform API begonnen gids ​ bevat een video en instructies voor het invoeren van de inzamelingen van Postman. Bovendien wordt een lijst van de inzamelingen van Postman voor elke dienst verstrekt.

Wat zijn de systeemvereisten voor Experience Platform? what-are-the-system-requirements-for-platform

Afhankelijk van of u de UI of API gebruikt, zijn de volgende systeemvereisten van toepassing:

voor op UI gebaseerde verrichtingen:

voor API en ontwikkelaarinteractie:

Fouten en problemen oplossen errors-and-troubleshooting

Hieronder volgt een lijst met fouten die kunnen optreden bij het gebruik van een Experience Platform -service. Voor het oplossen van problemengidsen op de individuele Experience Platform diensten, zie de ​ folder van het de dienstoplossen van problemen ​ hieronder.

API-statuscodes api-status-codes

De volgende statuscodes kunnen worden gevonden op elke Experience Platform -API. Elk artikel heeft verschillende oorzaken en daarom zijn de toelichtingen in deze paragraaf algemeen van aard. Voor meer details betreffende specifieke fouten in de individuele Experience Platform diensten, te zien gelieve de ​ folder van het de dienstoplossen van problemen ​ hieronder.

Koptekstfouten aanvragen request-header-errors

Voor alle API-aanroepen in Experience Platform zijn specifieke aanvraagheaders vereist. Om te zien welke kopballen voor de individuele diensten worden vereist, gelieve te zien de ​ documentatie van de Verwijzing API ​. Om de waarden voor de vereiste authentificatiekopballen te vinden, zie het ​ leerprogramma van de Authentificatie ​. Als een van deze headers ontbreekt of ongeldig is bij het aanroepen van een API, kunnen de volgende fouten optreden.

OAuth-token ontbreekt oauth-token-is-missing

{
    "error_code": "403010",
    "message": "Oauth token is missing."
}

Dit foutbericht wordt weergegeven wanneer een Authorization -header ontbreekt in een API-aanvraag. Zorg ervoor dat de machtigingheader is opgenomen met een geldig toegangstoken voordat u het opnieuw probeert.

OAuth-token is niet geldig oauth-token-is-not-valid

{
    "error_code": "401013",
    "message": "Oauth token is not valid"
}

Dit foutbericht wordt weergegeven wanneer het toegangstoken in de header van Authorization niet geldig is. Zorg ervoor dat het teken correct is ingegaan, of ​ produceert een nieuw teken ​ in de Console van Adobe I/O.

API-sleutel is vereist api-key-is-required

{
    "error_code": "403000",
    "message": "Api Key is required"
}

Dit foutbericht wordt weergegeven wanneer een API-sleutelheader (x-api-key) ontbreekt in een API-aanvraag. Zorg ervoor dat de header is opgenomen met een geldige API-sleutel voordat u het opnieuw probeert.

API-sleutel is ongeldig api-key-is-invalid

{
    "error_code": "403003",
    "message": "Api Key is invalid"
}

Dit foutbericht wordt weergegeven wanneer de waarde van de opgegeven API-sleutelheader (x-api-key) ongeldig is. Controleer of u de sleutel correct hebt ingevoerd voordat u het opnieuw probeert. Als u uw API sleutel niet kent, kunt u het in de ​ Console van Adobe I/O ​ vinden: in het lusje van de Integraties, navigeer aan de sectie van het Overzicht voor een specifieke integratie om de API sleutel onder de Credentials van de Cliënt te vinden.

Ontbrekende koptekst missing-header

{
    "error_code": "400003",
    "message": "Missing header"
}

Dit foutbericht wordt weergegeven wanneer een organisatiekoptekst (x-gw-ims-org-id) ontbreekt in een API-aanvraag. Zorg ervoor dat de koptekst is opgenomen in de id van uw organisatie voordat u het opnieuw probeert.

Profiel is niet geldig profile-is-not-valid

{
    "error_code": "403025",
    "message": "Profile is not valid"
}

Dit foutenbericht toont wanneer de gebruiker of de integratie van Adobe I/O (die door het ​ toegangstoken ​ in de Authorization kopbal wordt geïdentificeerd) niet gerechtigd is om vraag aan Experience Platform APIs voor de organisatie te maken die in de x-gw-ims-org-id kopbal wordt verstrekt. Zorg ervoor dat u de juiste id voor uw organisatie hebt opgegeven in de koptekst voordat u het opnieuw probeert. Als u uw organisatieidentiteitskaart niet kent, kunt u het in de ​ Console van Adobe I/O ​ vinden: in het lusje van de Integraties, navigeer aan de sectie van het Overzicht voor een specifieke integratie om identiteitskaart onder Credentials van de Cliënt te vinden.

Fout bij vernieuwen van tag refresh-etag-error

{
"errorMessage":"Supplied version=[\\\\\\\"a200a2a3-0000-0200-0000-123178f90000\\\\\\\"] does not match the current version on entity=[\\\\\\\"a200cdb2-0000-0200-0000-456179940000\\\\\\\"]"
}

U kunt een etiketfout ontvangen als een verandering op om het even welke bron of bestemmingsentiteit zoals stroom, verbinding, bronschakelaar, of doelverbinding door een andere API bezoeker werd aangebracht. Vanwege de niet-overeenkomende versie wordt de wijziging die u wilt aanbrengen, niet toegepast op de laatste versie van de entiteit.

Om dit op te lossen, moet u de entiteit opnieuw halen, ervoor zorgen dat uw veranderingen met nieuwe versie van de entiteit compatibel zijn, dan plaats het nieuwe etiket in de If-Match kopbal, en maak tot slot de API vraag.

Geldig inhoudstype niet opgegeven valid-content-type-not-specified

{
    "type": "/placeholder/type/uri",
    "status": 400,
    "title": "BadRequestError",
    "detail": "A valid content-type must be specified"
}

Dit foutbericht wordt weergegeven wanneer een POST-, PUT- of PATCH-aanvraag een ongeldige of ontbrekende Content-Type header heeft. Zorg ervoor dat de koptekst in de aanvraag is opgenomen en dat de waarde ervan application/json is.

Gebruikersgebied ontbreekt user-region-is-missing

{
    "error_code": "403027",
    "message": "User region is missing"
}

Dit foutbericht wordt weergegeven in een van de twee onderstaande gevallen:

Servicemap voor problemen service-troubleshooting-directory

Hieronder volgt een lijst met probleemoplossingsgidsen en API-naslagdocumentatie voor Experience Platform API's. Elke gids voor probleemoplossing biedt antwoorden op veelgestelde vragen en oplossingen voor problemen die specifiek zijn voor afzonderlijke Experience Platform -services. De API verwijzingsdocumenten verstrekken een uitvoerige gids aan alle beschikbare eindpunten voor elke dienst, en tonen de instanties van de steekproefaanvraag, reacties, en foutencodes die u kunt ontvangen.