Aan de slag met journey-API's

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

tussenpersoon
Gebruiker

CAUTION

zoekend Adobe Journey Optimizer? Klik hier voor de documentatie van Journey Optimizer.

Deze documentatie verwijst naar erfenismaterialen van Journey Orchestration die door Journey Optimizer zijn vervangen. Neem contact op met uw accountteam als u vragen hebt over uw toegang tot Journey Orchestration of Journey Optimizer.

Informatie over afkappings- en beperkings-API's

Wanneer u een databron of een actie configureert, maakt u een verbinding met een systeem om extra informatie op te halen voor gebruik in uw journeys of om berichten of API-oproepen te versturen.

Journey-API's ondersteunen tot 5000 gebeurtenissen per seconde, maar sommige externe systemen of API's hebben mogelijk geen equivalente verwerkingscapaciteit. Om overbelasting van deze systemen te voorkomen kunt u API's voor Afkappen en Beperken gebruiken om het aantal per seconde verzonden gebeurtenissen te beperken.

Telkens wanneer een API-oproep wordt uitgevoerd door journeys, passeert deze de API-engine. Als de in de API ingestelde limiet is bereikt, wordt de oproep geweigerd als u de afkappings-API gebruikt, of tot 6 uur in een wachtrij geplaatst en zo snel mogelijk verwerkt in de volgorde van ontvangst als u de beperkings-API gebruikt.

Bijvoorbeeld, laten wij zeggen dat u een het begrenzen of vertragen regel van 100 vraag per seconde voor uw extern systeem hebt bepaald. Uw systeem wordt opgeroepen door een aangepaste actie in 10 verschillende journeys. Indien één journey 200 oproepen per seconde ontvangt, gebruikt deze de 100 beschikbare slots en de 100 resterende slots verwijderen of in een wachtrij plaatsen. Aangezien het maximumaantal is overschreden, hebben de andere 9 journeys geen slot meer. Deze granulariteit helpt het externe systeem te beschermen tegen overbelasting en vastlopen.

IMPORTANT

Afkappingsregels worden op sandboxniveau geconfigureerd voor een specifiek eindpunt (de opgeroepen URL), maar globaal voor alle journeys van deze sandbox.

Beperkingsregels worden voor productiesandboxen alleen geconfigureerd voor een specifiek eindpunt, maar globaal voor alle journeys in alle sandboxes. U kunt slechts één beperkingsconfiguratie per organisatie hebben.

Voor meer informatie over werken met deze API's raadpleegt u deze secties:

Beide API's worden ook beschreven in een Swagger-bestand dat hier beschikbaar is.

Capaciteit gegevensbronnen en aangepaste acties capacity

Voor externe gegevensbronnen is het maximum aantal oproepen per seconde beperkt tot 15. Als deze limiet wordt overschreden, worden alle verdere oproepen ofwel afgewezen ofwel in de wachtrij geplaatst, afhankelijk van de gebruikte API. Het is mogelijk om deze limiet te verhogen voor externe privédatabronnen door contact op te nemen met Adobe om het eindpunt op te nemen in de lijst van gewenste personen, maar dit is geen optie voor externe openbare databronnen. * Leer hoe u databronnen kunt configureren.

NOTE

Als een databron een aangepaste authenticatie gebruikt met een ander eindpunt dan het eindpunt dat voor de databron wordt gebruikt, moet u contact opnemen met Adobe om ook dat eindpunt in de lijst van gewenste personen op te nemen.

Voor aangepaste acties moet u de capaciteit van uw externe API evalueren. Als Journey Optimizer bijvoorbeeld 1000 oproepen per seconde verstuurt en uw systeem slechts 100 oproepen per seconde kan ondersteunen, moet u een afkappings- of beperkingsconfiguratie definiëren zodat uw systeem niet verzadigd raakt. Ontdek hoe u acties kunt configureren

API-toegang instellen api

Om deze API's met uw Journey Orchestration-versie te gebruiken moet u de AdobeI/O-console gebruiken. Journey Orchestration API-toegang wordt ingesteld via de onderstaande stappen. Elk van deze stappen is gedetailleerd beschreven in de Adobe I/O-documentatie.

CAUTION

Om certificaten te beheren in Adobe I/O hebt u systeembeheerders rechten nodig voor de organisatie of een ontwikkelaarsaccount in de Admin-console.

Controleer of u een digitaal certificaat hebt, of maak er zo nodig een. De bij het certificaat geleverde openbare en privésleutels zijn nodig bij de volgende stappen.
Maak een nieuwe integratie met Journey Orchestration Service in Adobe I/O en configureer deze. De toegang tot het productprofiel is nodig voor Journey Orchestration en Adobe Experience Platform. Uw referenties worden dan gegenereerd (API-sleutel, klantgeheim…).

CAUTION

De JWT-methode voor het genereren van toegangstokens is afgekeurd. Alle nieuwe integraties moeten worden gecreeerd gebruikend de Server-aan-Server authentificatiemethode . Adobe raadt u ook aan uw bestaande integratie te migreren naar de OAuth-methode.

Lees de volgende belangrijke documentatie:
De gids van de migratie voor uw toepassingen van JWT aan OAuth ,
De gids van de implementatie voor nieuwe en oude toepassingen met OAuth ,
Voordelen om de Server-aan-Server methode van OAuth te gebruiken geloofsbrieven

Om een veilige Adobe I/O API-sessie tussen services tot stand te brengen moet elk verzoek aan een Adobe-service de onderstaande informatie bevatten in de autorisatieheader.

curl -X GET https://journey.adobe.io/authoring/XXX \
 -H 'Authorization: Bearer <ACCESS_TOKEN>' \
 -H 'x-api-key: <API_KEY>' \
 -H 'x-gw-ims-org-id: <ORGANIZATION>'

<ORGANIZATION>: dit is uw persoonlijke ORGANISATIE-ID. Adobe verstrekt één ORGANISATIE-ID voor elk van uw instanties. Voor het verkrijgen van uw ORGANISATIE-ID-waarde raadpleegt u uw beheerder of uw technische contactpersoon bij Adobe. U kunt hem ook ophalen in Adobe I/O wanneer u een nieuwe integratie maakt, in de licentielijst (zie de Adobe I/O-documentatie).
<ACCESS_TOKEN>: Uw persoonlijk toegangstoken
<API_KEY>: uw persoonlijke API-sleutel. Deze wordt geleverd in Adobe I/O na het maken van een nieuwe integratie met Journey Orchestration Service.

recommendation-more-help

4f4a00c1-77c9-4eee-84df-bbe6206c3ab9