Introdução às APIs de jornadas
Sobre APIs de limite e limitação
Ao configurar uma fonte de dados ou uma ação, você estabelece uma conexão com um sistema para recuperar informações adicionais e usar em suas jornadas ou enviar mensagens ou chamadas de API.
As APIs de jornadas comportam até 5000 eventos por segundo, mas alguns sistemas externos ou APIs podem não ter uma taxa de transferência equivalente. Para evitar a sobrecarga desses sistemas, você pode usar as APIs de Limite e Limitação para limitar o número de eventos enviados por segundo.
Toda vez que uma chamada de API é executada pelas jornadas, ela passa pelo mecanismo da API. Caso o limite definido na API seja atingido, a chamada será rejeitada se estiver usando a API de limite ou enfileirada por até 6 horas e processada o mais rápido possível na ordem em que foi recebida, se estiver usando a API de limitação.
Por exemplo, digamos que você tenha definido uma regra de limitação ou limitação de 100 chamadas por segundo para o sistema externo. Seu sistema é chamado por uma ação personalizada em 10 jornadas diferentes. Se uma jornada receber 200 chamadas por segundo, ela usará os 100 slots disponíveis e descartará ou colocará em fila os 100 slots restantes. Como a taxa máxima foi excedida, não restará nenhum slot para as outras 9 jornadas. Essa granularidade ajuda a proteger o sistema externo contra sobrecarga e falhas.
Para obter mais informações sobre como trabalhar com essas APIs, consulte estas seções:
Ambas as APIs também estão descritas em um arquivo do Swagger disponível aqui.
Capacidade de ações personalizadas e fontes de dados capacity
Para fontes de dados externas, o número máximo de chamadas por segundo é limitado a 15. Se esse limite for excedido, as chamadas adicionais serão descartadas ou enfileiradas, dependendo da API utilizada. É possível aumentar esse limite para fontes de dados externas privadas entrando em contato com a Adobe para incluir o ponto de acesso na lista de permissões, mas essa não é uma opção para fontes de dados externas públicas. * Saiba como configurar fontes de dados.
Para ações personalizadas, é necessário avaliar a capacidade de sua API externa. Por exemplo, se o Journey Optimizer envia 1000 chamadas por segundo e o sistema permite apenas 100 chamadas por segundo, é necessário definir uma configuração de limite ou limitação para não sobrecarregar o sistema. Saiba como configurar ações
Configuração do acesso à API api
Para usar essas APIs com a sua instância do Journey Orchestration, é necessário usar o console do Adobe I/O. O acesso à API do Journey Orchestration é configurado pelas etapas abaixo. Cada uma dessas etapas é detalhada na documentação do Adobe I/O.
- Verifique se você tem um certificado digital ou crie um, se necessário. As chaves públicas e privadas fornecidas com o certificado são necessárias nas etapas a seguir.
- Crie uma nova integração para o serviço do Journey Orchestration no Adobe I/O e configure-a. O acesso ao perfil do produto é necessário para o Journey Orchestration e a Adobe Experience Platform. Suas credenciais serão geradas (chave da API, segredo do cliente etc.).
Para estabelecer uma sessão de API segura e de serviço a serviço no Adobe I/O, cada solicitação para um serviço da Adobe deve incluir as informações abaixo no cabeçalho de autorização.
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>: esta é a ID de ORGANIZAÇÃO pessoal. Uma ID de ORGANIZAÇÃO é fornecida pela Adobe para cada uma das instâncias. Para obter o valor da ID de ORGANIZAÇÃO, consulte seu administrador ou contato técnico da Adobe. Você também pode recuperá-la no Adobe I/O ao criar uma nova integração, na lista de licenças (consulte a documentação do Adobe I/O).
-
<ACCESS_TOKEN>: Seu token de acesso pessoal
-
<API_KEY>: sua chave de API pessoal. Ela é fornecida no Adobe I/O após criar uma nova integração com o serviço do Journey Orchestration.