Trabalhar com a API de limite work
A API de limite ajuda a criar, configurar e monitorar as configurações de limite.
Esta seção fornece informações globais sobre como trabalhar com a API. Uma descrição detalhada da API está disponível na documentação das APIs do Adobe Journey Optimizer.
Descrição da API de limite e coleção do Postman description
A tabela abaixo lista os comandos disponíveis para a API de limitação. Informações detalhadas, incluindo amostras de solicitações, parâmetros e formatos de resposta estão disponíveis na documentação das APIs do Adobe Journey Optimizer.
{uid}/deploy{uid}/undeploy{uid}/canDeploy{uid}{uid}{uid}When a configuration is created or updated, a check is automatically performed to guarantee the syntax and the integrity of the payload.
If some problems occur, the operation returns warning or errors to help you correct the configuration.
Além disso, uma coleção do Postman está disponível aqui para ajudá-lo na configuração de teste.
Esta coleção foi configurada para compartilhar a coleção de Variáveis Postman gerada por meio das Integrações do Console Adobe I/O > Experimente > Baixar para Postman, que gera um arquivo de Ambiente Postman com os valores de integrações selecionados.
Após o download e o upload para o Postman, é necessário adicionar três variáveis: {JO_HOST},{BASE_PATH} e {SANDBOX_NAME}.
{JO_HOST}: Journey Optimizer URL do Gateway.{BASE_PATH}: ponto de entrada da API.{SANDBOX_NAME}: o cabeçalho x-sandbox-name (por exemplo, “prod”) correspondente ao nome da sandbox na qual as operações da API ocorrerão. Consulte a visão geral das sandboxes para obter mais informações.
Endpoint configuration
Here is the basic structure of an endpoint configuration:
{
"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>
}
},
...
}
}
maxHttpConnections value has been set, a default maxHttpConnections = -1 is added into the deployed configuration, and Journey Optimizer uses the default system value.Exemplo:
{
"url": "https://api.example.org/data/2.5/*",
"methods": [
"GET"
],
"services": {
"dataSource": {
"rating": {
"maxCallsCount": 500,
"periodInMs": 1000
}
}
}
}
Warning and errors
When a canDeploy method is called, the process validates the configuration and returns the validation status identified by its Unique ID, either:
"ok" or "error"
The potential errors are:
- ERR_ENDPOINTCONFIG_100: capping config: missing or invalid url
- ERR_ENDPOINTCONFIG_101: capping config: malformed url
- ERR_ENDPOINTCONFIG_102: capping config: malformed url: wildchar in url not allowed in host:port
- ERR_ENDPOINTCONFIG_103: capping config: missing HTTP methods
- ERR_ENDPOINTCONFIG_104: capping config: no call rating defined
- ERR_ENDPOINTCONFIG_107: capping config: invalid max calls count (maxCallsCount)
- ERR_ENDPOINTCONFIG_108: configuração de limitação: contagem máxima de chamadas inválida (periodInMs)
- ERR_ENDPOINTCONFIG_111: configuração de limitação: não é possível criar a configuração de ponto de extremidade: carga inválida
- ERR_ENDPOINTCONFIG_112: configuração de limitação: não é possível criar a configuração de ponto de extremidade: esperando uma carga JSON
- ERR_AUTHORING_ENDPOINTCONFIG_1: nome de serviço inválido
<!--<given value>-->: deve ser ‘dataSource’ ou ‘action’
O aviso potencial é:
ERR_ENDPOINTCONFIG_106: configuração de limitação: máximo de conexões HTTP não definidas: sem limitação por padrão
Casos de uso
Esta seção lista casos de uso importantes para gerenciar configurações de limite no Journey Optimizer e os comandos de API associados necessários para implementar o caso de uso.
Detalhes sobre cada comando de API estão disponíveis na descrição da API e coleção do Postman.
Chamadas de API a serem usadas:
list- Recupera as configurações existentes.create- Cria uma nova configuração.candeploy- Verifica se a configuração pode ser implantada.deploy- Implanta a configuração.
Chamadas de API a serem usadas:
list- Recupera as configurações existentes.get- Obtém detalhes de uma configuração específica.update- Modifica a configuração.candeploy- Verifica a qualificação da implantação.deploy- Implanta a configuração.
Chamadas de API a serem usadas:
list- Recupera as configurações existentes.undeploy- Desimplanta a configuração.delete- Remove a configuração.
Em apenas uma chamada de API, você pode desimplantar e excluir a configuração usando o parâmetro forceDelete.
Chamadas de API a serem usadas:
list- Recupera as configurações existentes.delete(com parâmetroforceDelete) - Força a exclusão de uma configuração implantada em uma única etapa.
| note |
|---|
| NOTE |
| Uma reimplantação é necessária após atualizar uma configuração já implantada. |
Chamadas de API a serem usadas:
list- Recupera as configurações existentes.get- Obtém detalhes de uma configuração específica.update- Modifica a configuração.undeploy- Desimplanta a configuração antes de aplicar as alterações.candeploy- Verifica a qualificação da implantação.deploy- Implanta a configuração atualizada.