Journey OrchestrationLe API di supportano eventi 5000/secondi, ma alcuni sistemi o API esterni non potrebbero avere una velocità effettiva equivalente. Ecco perché Journey Orchestration viene fornito con una funzione dedicata denominata API di limitazione per monitorare e limitare il tasso che imponiamo ai sistemi esterni.
Durante la configurazione di un’origine dati, definirai una connessione a un sistema per recuperare informazioni aggiuntive che verranno utilizzate nei percorsi oppure, per una definizione di azione, configurerai la connessione di un sistema di terze parti per l’invio di messaggi o chiamate API. Ogni volta che una chiamata API viene eseguita dal Percorso, l’API di limitazione viene interrogata, la chiamata viene eseguita tramite il motore API. Se è definito un limite, la chiamata viene rifiutata e il sistema esterno non verrà sovraccaricato.
Per le origini dati esterne, il numero massimo di chiamate al secondo è impostato su 15. Se il numero di chiamate supera il 15 al secondo, le chiamate rimanenti vengono scartate. Puoi aumentare questo limite per le origini dati esterne private. Contatta l’Adobe per includere l’endpoint nell’inserire nell'elenco Consentiti. Ciò non è possibile per le fonti di dati esterne pubbliche. Per ulteriori informazioni sulle best practice e le protezioni durante l’integrazione di sistemi esterni, consulta questo articolo page.
Per ulteriori informazioni sulla configurazione dell’azione o dell’origine dati, consulta Informazioni sulle azioni o Informazioni sulle origini dati
La Journey Orchestration L’API di limitazione di utilizzo è descritta in un file Swagger disponibile qui.
Per utilizzare questa API con la Journey Orchestration ad esempio, è necessario utilizzare la console AdobeI/O. Per iniziare, segui questo Guida introduttiva alla console Adobe Developer e quindi utilizzare le sezioni di questa pagina.
Per testare e preparare l’integrazione è disponibile una raccolta Postman qui.
Journey Orchestration L’accesso alle API è configurato attraverso i passaggi seguenti. Ciascuno di questi passaggi è descritto nella sezione Documentazione di Adobe I/O.
Per gestire i certificati in Adobe I/O, assicurati di disporre di Amministratore di sistema diritti dell'organizzazione o account sviluppatore in Admin Console.
Per stabilire una sessione API di Adobe I/O servizio-servizio sicura, ogni richiesta a un servizio Adobe deve includere nell’intestazione Autorizzazione le informazioni riportate di seguito.
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>: Si tratta dell’ID organizzazione personale, un ID organizzazione viene fornito per Adobe per ciascuna istanza :
Per ottenere il valore dell’ID ORGANIZZAZIONE, rivolgiti all’amministratore o al contatto tecnico Adobe. È inoltre possibile recuperarlo in Adobe I/O durante la creazione di una nuova integrazione, nell’elenco delle licenze (consulta Documentazione di Adobe I/O).
<access_token>: Token di accesso personale, recuperato durante lo scambio di JWT tramite una richiesta POST.
<api_key>: la tua chiave API personale. Viene fornito in Adobe I/O dopo la creazione di una nuova integrazione in Journey Orchestration Servizio.
L’API di limitazione di utilizzo consente di creare, configurare e monitorare le configurazioni di limitazione di utilizzo.
Metodo | Path | Descrizione |
---|---|---|
POST | list/endpointConfigs | Ottieni un elenco delle configurazioni di limiti endpoint |
POST | /endpointConfigs | Creare una configurazione di limite endpoint |
POST | /endpointConfigs/{uid} /deploy |
Distribuzione di una configurazione di limite endpoint |
POST | /endpointConfigs/{uid} /undeploy |
Disdistribuire una configurazione di limite endpoint |
POST | /endpointConfigs/{uid} /canDeploy |
Controlla se è possibile distribuire o meno una configurazione di limite endpoint |
PUT | /endpointConfigs/{uid} |
Aggiornare una configurazione di limite endpoint |
GET | /endpointConfigs/{uid} |
Recuperare una configurazione di limite endpoint |
DELETE | /endpointConfigs/{uid} |
Eliminare una configurazione di limite di livello |
Quando una configurazione viene creata o aggiornata, viene eseguito automaticamente un controllo per garantire la sintassi e l’integrità del payload.
Se si verificano alcuni problemi, l'operazione restituisce un avviso o degli errori per facilitare la correzione della configurazione.
La struttura di base di una configurazione dell’endpoint è la seguente:
{
"url": "<endpoint URL>", //wildcards are allowed in the endpoint URL
"methods": [ "<HTTP method such as GET, POST, >, ...],
"services": {
"<service name>": { . //must be "action" or "dataSource"
"maxHttpConnections": <max connections count to the endpoint>
"rating": {
"maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
"periodInMs": <integer value greater than 0>
}
},
...
}
}
`{
"url": "https://api.example.org/data/2.5/*",
"methods": [
"GET"
],
"services": {
"dataSource": {
"maxHttpConnections": 30000,
"rating": {
"maxCallsCount": 5000,
"periodInMs": 1000
}
}
},
"orgId": "<IMS Org Id>"
}
Quando un canDeploy viene chiamato , il processo convalida la configurazione e restituisce lo stato di convalida identificato dal relativo ID univoco:
"ok" or "error"
Gli errori potenziali sono:
<!--<given value>-->
: deve essere 'dataSource' o 'action'L'avviso potenziale è:
ERR_ENDPOINTCONFIG_106: configurazione di tappping: connessioni HTTP massime non definite: nessuna limitazione per impostazione predefinita
In questa sezione sono disponibili i cinque casi d’uso principali che è possibile eseguire per gestire la configurazione dei limiti in Journey Orchestration.
Per facilitare i test e la configurazione, è disponibile una raccolta Postman qui.
Questa raccolta Postman è stata configurata per condividere la raccolta di variabili Postman generata tramite Integrazioni della console Adobe I/O > Prova > Scarica per Postman, che genera un file di ambiente Postman con i valori di integrazioni selezionati.
Una volta scaricata e caricata in Postman, devi aggiungere tre variabili: {JO_HOST}
,{Base_Path}
e {SANDBOX_NAME}
.
{JO_HOST}
: Journey Orchestration URL gateway{BASE_PATH}
: punto di ingresso per l’API. Il valore è '/authoring'{SANDBOX_NAME}
: intestazione x-sandbox-name (ad esempio, "prod") corrispondente al nome della sandbox in cui avranno luogo le operazioni API. Consulta la sezione panoramica sulle sandbox per ulteriori informazioni.Nella sezione seguente, trovi l’elenco delle chiamate API rimanenti ordinate per eseguire il caso d’uso.
Caso d’uso n° 1: Creazione e distribuzione di una nuova configurazione di tappatura
Caso d’uso n° 2: Aggiornare e distribuire una configurazione di limite non ancora distribuita
Caso d’uso n° 3: Disdistribuire ed eliminare una configurazione di limitazione distribuita
Caso d’uso n° 4: Elimina una configurazione di limitazione distribuita.
In una sola chiamata API, puoi annullare la distribuzione ed eliminare la configurazione utilizzando il parametro forceDelete .
Caso d’uso n° 5: Aggiornare una configurazione di limite già distribuita