Uso de la API de límite work
La API de límite le ayuda a crear, configurar y supervisar sus configuraciones de límite.
Esta sección proporciona información global sobre cómo trabajar con la API. Hay disponible una descripción detallada de la API en Documentación de las API de Adobe Journey Optimizer.
Descripción de la API de límite y colección de Postman description
En la tabla siguiente se enumeran los comandos disponibles para la API de límite. Encontrará información detallada, incluidos ejemplos de solicitudes, parámetros y formatos de respuesta, en la documentación de API de Adobe Journey Optimizer.
{uid}
/deploy{uid}
/undeploy{uid}
/canDeploy{uid}
{uid}
{uid}
Cuando se crea o actualiza una configuración, se realiza automáticamente una comprobación para garantizar la sintaxis y la integridad de la carga útil.
Si se producen algunos problemas, la operación devuelve advertencias o errores para ayudarle a corregir la configuración.
Además, hay disponible una colección de Postman aquí que le ayudará en la configuración de las pruebas.
Esta colección se ha configurado para compartir la colección Variable de Postman generada mediante Integraciones de la consola de Adobe I/O > Probarla > Descargar para Postman, que genera un archivo de entorno de Postman con los valores de integraciones seleccionados.
Una vez descargado y cargado en Postman, debe añadir tres variables: {JO_HOST}
,{BASE_PATH}
y {SANDBOX_NAME}
.
{JO_HOST}
: URL de puerta de enlace Journey Optimizer.{BASE_PATH}
: punto de entrada para la API.{SANDBOX_NAME}
: el encabezado x-sandbox-name (por ejemplo, “prod”) correspondiente al nombre de la zona protegida donde se realizarán las operaciones de API. Consulte la información general sobre las zonas protegidas para obtener más detalles.
Configuración de extremo
Esta es la estructura básica de una configuración de extremo:
{
"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 (optional)>
"rating": {
"maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
"periodInMs": <integer value greater than 0>
}
},
...
}
}
Por ejemplo:
`{
"url": "https://api.example.org/data/2.5/*",
"methods": [
"GET"
],
"services": {
"dataSource": {
"rating": {
"maxCallsCount": 500,
"periodInMs": 1000
}
}
}
}
Advertencia y errores
Cuando se llama a un método canDeploy, el proceso valida la configuración y devuelve el estado de validación identificado por su identificador único, ya sea:
"ok" or "error"
Los posibles errores son:
- ERR_ENDPOINTCONFIG_100: configuración de límite: falta URL o no es válida
- ERR_ENDPOINTCONFIG_101: configuración de límite: URL mal formada
- ERR_ENDPOINTCONFIG_102: configuración de límite: url con formato incorrecto: no se permite el carácter comodín en la dirección URL en host:puerto
- ERR_ENDPOINTCONFIG_103: configuración de límite: faltan métodos HTTP
- ERR_ENDPOINTCONFIG_104: configuración de límite: no se definió la clasificación de llamadas
- ERR_ENDPOINTCONFIG_107: configuración de límite: recuento máximo de llamadas no válido (maxCallsCount)
- ERR_ENDPOINTCONFIG_108: configuración de límite: recuento máximo de llamadas no válido (periodInMs)
- ERR_ENDPOINTCONFIG_111: configuración de límite: no se puede crear la configuración de extremo: carga útil no válida
- ERR_ENDPOINTCONFIG_112: configuración de límite: no se puede crear la configuración de extremo: esperando una carga útil JSON
- ERR_AUTHORING_ENDPOINTCONFIG_1: nombre de servicio no válido
<!--<given value>-->
: debe ser 'dataSource' o 'action'
La advertencia potencial es:
ERR_ENDPOINTCONFIG_106: configuración de límite: máximo de conexiones HTTP no definidas: sin limitación de forma predeterminada
Casos de uso
En esta sección se enumeran los casos de uso clave para administrar las configuraciones de límite en Journey Optimizer y los comandos de API asociados necesarios para implementar el caso de uso.
Encontrará detalles sobre cada comando de API en Descripción de la API y recopilación de Postman.
Llamadas de API para utilizar:
list
- Recupera configuraciones existentes.create
- Crea una nueva configuración.candeploy
: comprueba si se puede implementar la configuración.deploy
- Implementa la configuración.
Llamadas de API para utilizar:
list
- Recupera configuraciones existentes.get
: obtiene detalles de una configuración específica.update
- Modifica la configuración.candeploy
- Comprueba la idoneidad de la implementación.deploy
- Implementa la configuración.
Llamadas de API para utilizar:
list
- Recupera configuraciones existentes.undeploy
- Anula la implementación de la configuración.delete
- Quita la configuración.
Solo en una llamada de API puede anular la implementación y eliminar la configuración con el parámetro forceDelete
.
Llamadas de API para utilizar:
list
- Recupera configuraciones existentes.delete
(conforceDelete
parámetro) - Fuerza la eliminación de una configuración implementada en un solo paso.
note note |
---|
NOTE |
Se requiere una nueva implementación después de actualizar una configuración ya implementada. |
Llamadas de API para utilizar:
list
- Recupera configuraciones existentes.get
: obtiene detalles de una configuración específica.update
- Modifica la configuración.undeploy
: anula la implementación de la configuración antes de aplicar los cambios.candeploy
- Comprueba la idoneidad de la implementación.deploy
- Implementa la configuración actualizada.