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.

Método
Caminho
Descrição
POST
list/endpointConfigs
Obter uma lista das configurações de limite de endpoint
POST
/endpointConfigs
Criar uma configuração de limite de endpoint
POST
/endpointConfigs/{uid}/deploy
Implantar uma configuração de limite de ponto de extremidade
POST
/endpointConfigs/{uid}/undeploy
Desimplantar uma configuração de limite de endpoint
POST
/endpointConfigs/{uid}/canDeploy
Verificar se uma configuração de limite de ponto de extremidade pode ser implantada ou não
PUT
/endpointConfigs/{uid}
Atualizar uma configuração de limite de ponto de extremidade
GET
/endpointConfigs/{uid}
Retrieve an endpoint capping configuration
DELETE
/endpointConfigs/{uid}
Delete an enpoint capping configuration

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>
            }
        },
        ...
    }
}
IMPORTANT
The maxHttpConnections parameter is optional. It allows you to restrict the number of connections Journey Optimizer will open to the external system.
The max value that can be set is 400. If nothing is specified, then the system may open up to multiple thousands of connections depending on the dynamic scaling of the system.
When the capping configuration is deployed, if no 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
      }
    }
  }
}
IMPORTANT
A configuração só estará ativa depois de chamar o ponto de extremidade deploy.

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.

Criar e implantar uma nova configuração de limite

Chamadas de API a serem usadas:

  1. list - Recupera as configurações existentes.
  2. create - Cria uma nova configuração.
  3. candeploy - Verifica se a configuração pode ser implantada.
  4. deploy - Implanta a configuração.
Atualizar e implantar uma configuração de limitação (ainda não implantada)

Chamadas de API a serem usadas:

  1. list - Recupera as configurações existentes.
  2. get - Obtém detalhes de uma configuração específica.
  3. update - Modifica a configuração.
  4. candeploy - Verifica a qualificação da implantação.
  5. deploy - Implanta a configuração.
Desimplantar e excluir uma configuração de limite implantada

Chamadas de API a serem usadas:

  1. list - Recupera as configurações existentes.
  2. undeploy - Desimplanta a configuração.
  3. delete - Remove a configuração.
Excluir uma configuração de limite implantada em uma etapa

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:

  1. list - Recupera as configurações existentes.
  2. delete(com parâmetro forceDelete) - Força a exclusão de uma configuração implantada em uma única etapa.
Atualizar uma configuração de limite já implantada
note
NOTE
Uma reimplantação é necessária após atualizar uma configuração já implantada.

Chamadas de API a serem usadas:

  1. list - Recupera as configurações existentes.
  2. get - Obtém detalhes de uma configuração específica.
  3. update - Modifica a configuração.
  4. undeploy - Desimplanta a configuração antes de aplicar as alterações.
  5. candeploy - Verifica a qualificação da implantação.
  6. deploy - Implanta a configuração atualizada.
recommendation-more-help
journey-optimizer-help