Kom igång med API:er för resor

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

Ämnen:

Skapat för:

Mellanliggande
Användare

CAUTION

Söker du Adobe Journey Optimizer? Klicka här för Journey Optimizer-dokumentation.

Den här dokumentationen hänvisar till äldre Journey Orchestration-material som har ersatts av Journey Optimizer. Kontakta ditt kontoteam om du har frågor om din åtkomst till Journey Orchestration eller Journey Optimizer.

Om API:er för reglering och begränsning

När du konfigurerar en datakälla eller en åtgärd upprättar du en anslutning till ett system för att antingen hämta ytterligare information som ska användas under dina resor eller skicka meddelanden eller API-anrop.

API:er för resor har stöd för upp till 5 000 händelser per sekund, men vissa externa system eller API:er har kanske inte samma genomströmning. Om du vill förhindra att dessa system överbelastas kan du använda API:erna Reglering och Begränsning som begränsar antalet händelser som skickas per sekund.

Varje gång ett API-anrop utförs via resor skickas det via API-motorn. Om gränsvärdet i API:et nås avvisas anropet om du använder API:et för reglering, eller köas upp till sex timmar och behandlas så snart som möjligt i den ordning som de togs emot om du använder API:et för begränsning.

Anta till exempel att du har definierat en begränsning eller begränsning på 100 anrop per sekund för det externa systemet. Ditt system anropas av en anpassad åtgärd på tio olika resor. Om en resa tar emot 200 anrop per sekund används de 100 tillgängliga facken och de 100 återstående facken tas bort eller köas. Eftersom den högsta nivån har överskridits har de övriga nio resorna inte några fack kvar. Denna precision hjälper till att skydda det externa systemet från överbelastning och krascher.

IMPORTANT

Regleringsregler är konfigurerade på sandlådenivå, för en specifik slutpunkt (den anropade URL:en), men är globala till alla resor i den sandlådan.

Begränsningsregler konfigureras endast för produktionssandlådor, för en specifik slutpunkt, men är globala för alla resor över alla sandlådor. Du kan bara ha en begränsningskonfiguration per organisation.

Mer information om hur du arbetar med dessa API:er finns i följande avsnitt:

Båda API:erna beskrivs också i en tillgänglig Swagger-fil här.

Datakällor och kapacitet för anpassade åtgärder capacity

För externa datakällor är det maximala antalet anrop per sekund begränsat till femton. Om den här gränsen överskrids, ignoreras eller köas eventuella ytterligare anrop beroende på vilket API som används. Det är möjligt att öka denna gräns för privata externa datakällor genom att kontakta Adobe för att inkludera slutpunkten i tillåtelselistan, men detta är inte ett alternativ för offentliga externa datakällor. * Läs mer om hur du konfigurerar datakällor.

NOTE

Om en datakälla använder en anpassad autentisering med en annan slutpunkt än den som används för datakällan måste du kontakta Adobe för att även inkludera den slutpunkten i tillåtelselistan.

För anpassade åtgärder måste du utvärdera kapaciteten för ditt externa API. Om Journey Optimizer t.ex. skickar 1 000 anrop per sekund och systemet bara har stöd för 100 anrop per sekund, måste du definiera en konfiguration för reglering eller begränsning så att systemet inte blir mättat. Läs mer om hur du konfigurerar åtgärder

Konfigurera API-åtkomst api

För att använda dessa API:er med instansen Journey Orchestration måste du till exempel använda Adobe I/O Console. Journey Orchestration API-åtkomst konfigureras genom stegen nedan. Varje steg beskrivs i Dokumentation för Adobe I/O.

CAUTION

Kontrollera att du är en berättigad systemadministratör i organisationen eller att du har ett utvecklarkonto i Admin Console för att hantera certifikat i Adobe I/O.

Kontrollera att du har ett digitalt certifikat eller skapa ett vid behov. De offentliga och privata nycklarna som tillhandahålls med certifikatet behövs i följande steg.
Skapa en ny integrering med Journey Orchestration Tjänst i Adobe I/O och konfigurera den. Du behöver åtkomst till produktprofilen för Journey Orchestration och till Adobe Experience Platform. Dina autentiseringsuppgifter genereras sedan (API-nyckel, klienthemlighet …).

CAUTION

JWT-metoden för att generera åtkomsttoken har tagits bort. Alla nya integreringar måste skapas med autentiseringsmetoden OAuth Server-till-server. Adobe rekommenderar också att du migrerar dina befintliga integreringar till OAuth-metoden.

Läs följande viktiga dokumentation:
Migreringsguide för dina program från JWT till OAuth,
Implementeringsguide för nya och gamla program med OAuth,
Fördelar med att använda inloggningsmetoden för OAuth Server-till-Server

För att upprätta en säker tjänst-till-tjänst Adobe I/O API-session måste varje begäran till en Adobe-tjänst innehålla informationen nedan i auktoriseringshuvudet.

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>: Detta är ditt personliga organisations-ID, och Adobe tillhandahåller ett organisations-ID för varje instans. Kontakta din administratör eller din teknikkunniga Adobe-kontakt för att få ditt organisations-ID-värde. Du kan även hämta det till Adobe I/O när du skapar en ny integrering i licenslistan (se Dokumentation för Adobe I/O).
<ACCESS_TOKEN>: Din personliga åtkomsttoken
<API_KEY>: Din egen API-nyckel. Det tillhandahålls i Adobe I/O efter att en ny integrering av tjänsten Journey Orchestration har skapats.

recommendation-more-help

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