Introducción a las API de recorridos
Acerca de las API de límite y limitación
Al configurar una fuente de datos o una acción, se establece una conexión con un sistema para recuperar información adicional que se utilizará en los recorridos o enviar mensajes o llamadas de API.
Las API de recorridos admiten hasta 5000 eventos por segundo, pero es posible que algunos sistemas externos o API no tengan un rendimiento equivalente. Para evitar sobrecargar estos sistemas, puede usar las API de límite y limitación para limitar el número de eventos enviados por segundo.
Cada vez que recorrido realiza una llamada a la API, esta pasa por el motor de API. Si se alcanza el límite establecido en la API, la llamada se rechaza (si utiliza la API de cierre) o se pone en cola hasta 6 horas y se procesa lo antes posible en el orden en que se recibió (si usa la API de limitación).
Por ejemplo, supongamos que ha definido una regla de límite o limitación de 100 llamadas por segundo para el sistema externo. Una acción personalizada llama al sistema en 10 recorridos diferentes. Si un recorrido recibe 200 llamadas por segundo, utilizará las 100 ranuras disponibles y descartará o pondrá en cola las 100 restantes. Como la velocidad máxima se ha superado, los otros 9 recorridos no tendrán ninguna ranura. Esta granularidad ayuda a proteger el sistema externo de sobrecargas y caídas.
Para obtener más información sobre cómo trabajar con estas API, consulte estas secciones:
Ambas API también se describen en un archivo Swagger disponible aquí.
Capacidad de fuentes de datos y acciones personalizadas capacity
Para fuentes de datos externas, el número máximo de llamadas por segundo está limitado a 15. Si se supera este límite, las llamadas adicionales se descartan o se ponen en cola según la API en uso. Es posible aumentar este límite para las fuentes de datos externas privadas poniéndose en contacto con Adobe para incluir en la lista de permitidos el extremo, pero esto no es una opción para las fuentes de datos externas públicas. * Obtenga información sobre cómo configurar fuentes de datos.
Para acciones personalizadas, debe evaluar la capacidad de su API externa. Por ejemplo, si Journey Optimizer envía 1000 llamadas por segundo y el sistema solo puede admitir 100, debe definir una configuración de límite o de limitación para que el sistema no se sature. Obtenga información sobre cómo configurar acciones
Configuración del acceso a API api
Para usar estas API con su instancia de Journey Orchestration, debe utilizar la consola de Adobe I/O. El acceso a la API de Journey Orchestration se configura mediante los pasos que siguen. Cada uno de estos pasos se detalla en la documentación de Adobe I/O.
- Compruebe que tiene un certificado digital o créese uno si es necesario. Las claves pública y privada proporcionadas con el certificado son necesarias en los siguientes pasos.
- Cree una nueva integración para el servicio de Journey Orchestration en Adobe I/O y configúrelo. El acceso al perfil del producto es necesario para Journey Orchestration y Adobe Experience Platform. A continuación, se generarán sus credenciales (clave de API, secreto de cliente…).
Para establecer una sesión segura de API de Adobe I/O de servicio a servicio, cada solicitud a un servicio de Adobe debe incluir la información siguiente en el encabezado Autorización.
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>: este es su ID de organización personal, Adobe proporciona uno para cada una de sus instancias. Para obtener el valor del ID de organización, consulte con su administrador o contacto técnico de Adobe. También puede recuperarlo en Adobe I/O al crear una nueva integración, en la lista de licencias (consulte la documentación de Adobe I/O).
-
<ACCESS_TOKEN>: Su token de acceso personal
-
<API_KEY>: su clave de API personal. Se proporciona en Adobe I/O después de crear una nueva integración con el servicio de Journey Orchestration.