Documentatie Experience Platform Overzicht van Experience Platform

Experience Platform Handleiding Veelgestelde vragen en problemen oplossen

Laatst bijgewerkt: 6 mei 2025

Gemaakt voor:

Ontwikkelaar

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 problemenhieronder.

Veelgestelde vragen

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

Wat zijn Experience Platform API's?

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 APIop Adobe I/O.

Hoe kan ik een API-aanvraag opmaken?

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 vraagsectie.

Wat is mijn organisatie?

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 Consoleworden 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?

Een API-sleutel is vereist als een header in alle API-aanvragen. Het kan door Adobe Developer Consoleworden 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?

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?

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?

Vele verrichtingen van PATCH in Experience Platform APIs gebruiken JSONkoorden 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 gidsvoor gedetailleerde informatie over vereiste syntaxis voor deze technologieën.

Kan ik Postman gebruiken om oproepen te doen naar Experience Platform API's?

Postmanis een nuttig hulpmiddel om vraag aan RESTful APIs te visualiseren. De Experience Platform API begonnen gidsbevat 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?

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

voor op UI gebaseerde verrichtingen:

Een moderne, standaard webbrowser. Hoewel de nieuwste versie van Chrome wordt aanbevolen, worden huidige en vorige grote releases van Firefox , Internet Explorer en Safari ook ondersteund.
- Elke keer dat een nieuwe hoofdversie wordt uitgebracht, ondersteunt Experience Platform de meest recente versie terwijl de ondersteuning voor de derde meest recente versie wordt stopgezet.
Alle browsers moeten cookies hebben en JavaScript ingeschakeld.

voor API en ontwikkelaarinteractie:

Een ontwikkelomgeving voor REST-, streaming- en WebHaak-integratie.

Fouten en problemen oplossen

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 problemenhieronder.

API-statuscodes

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 problemenhieronder.

Statuscode

Beschrijving

Mogelijke oorzaken

400

Ongeldig verzoek

Het verzoek is onjuist samengesteld, bevat geen sleutelinformatie en/of bevat een onjuiste syntaxis.

401

Verificatie mislukt

De aanvraag heeft geen verificatiecontrole doorstaan. Uw toegangstoken ontbreekt of is ongeldig. Zie de symbolische fouten van het type OAuthhieronder voor meer details.

403

Verboden

De bron is gevonden, maar u hebt niet de juiste referenties om deze te bekijken.
Een waarschijnlijke oorzaak van deze fout is dat u niet de vereiste toegangsbeheertoestemmingenzou kunnen hebben om tot het middel toegang te hebben of uit te geven. Lees hoe te krijgt de noodzakelijke op attribuut-gebaseerde toegangsbeheertoestemmingenom Experience Platform APIs te gebruiken.

404

Niet gevonden

De gevraagde bron is niet gevonden op de server. De bron is mogelijk verwijderd of het gevraagde pad is onjuist ingevoerd.

500

Interne serverfout

Dit is een serverfout. Als u vele gelijktijdige vraag maakt, kunt u de API grens bereiken en moet uw resultaten filtreren. (Zie de Catalog Service sub-gids van de de ontwikkelaarsgids van API op het filtreren gegevensom meer te leren.) Wacht even voordat u uw verzoek opnieuw probeert en neem contact op met de beheerder als het probleem zich blijft voordoen.

Koptekstfouten aanvragen

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

{
    "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

{
    "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 tekenin de Console van Adobe I/O.

API-sleutel is vereist

{
    "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

{
    "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/Ovinden: 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

{
    "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

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

Dit foutenbericht toont wanneer de gebruiker of de integratie van Adobe I/O (die door het toegangstokenin 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/Ovinden: 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

{
"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

{
    "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

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

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

Wanneer een onjuiste of misvormde kopbal van organisatieID (x-gw-ims-org-id) in een API verzoek wordt overgegaan. Zorg ervoor dat de juiste id van uw organisatie is opgenomen voordat u het opnieuw probeert.
Wanneer uw account (weergegeven door de opgegeven verificatiereferenties) niet is gekoppeld aan een productprofiel voor Experience Platform. Volg de stappen op het produceren van toegangsgeloofsbrievenin het de authentificatieleerprogramma van Experience Platform API om Experience Platform aan uw rekening toe te voegen en uw authentificatiegeloofsbrieven dienovereenkomstig bij te werken.

Servicemap voor problemen

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.

Service

API-naslag

Problemen oplossen

Toegangsbeheer

controle API van de Toegang

de gids van het de controleoplossen van problemenoplossing van de Toegang

Adobe Experience Platform-gegevensinscriptie

Batch Ingestion API

het oplossen van problemengids van de Inname van de Partij

Adobe Experience Platform-gegevensinscriptie

Streaming Ingestion API

Streaming het oplossen van problemengids van de Inname