Iniciar uma execução pela API (trigger)
A rota, os headers e o cuidado com o id da execução.
Escrito por Leôncio
Última atualização Há 41 minutos
Toda execução começa com um POST na API HTTP do skail:
POST {SKAIL_BASE_URL}/api/v1/trigger/{workload}/{versao}/{funcao}/{id}SKAIL_BASE_URL é o endereço do environment, o mesmo valor de SKAIL_SIDECAR, sem /api/v1 no final.
workload e versao são as duas partes de SKAIL_WORKLOAD da aplicação que roda a function.
funcao é o nome do método.
id é o id da execução e precisa ser um GUID.
O corpo é um array JSON com os argumentos da function, na ordem da assinatura. Os nomes das propriedades precisam ter a mesma caixa do tipo. Com caixa diferente, o campo chega com o valor padrão (false, 0, null), sem erro.
Headers
Authorization: Bearer {chave} skail-key: {chave} Skail-namespace: {namespace} Content-Type: application/jsonO id da execução
Quem dispara gera o GUID uma vez, reutiliza o mesmo valor nas novas tentativas desse disparo e guarda a relação com o id de negócio, por exemplo numa coluna do pedido. É por esse GUID que você acha a execução no Monitor. Com um GUID novo, o trigger inicia uma segunda execução.
Se o trigger falhar por rede, 429 ou 5xx, tente de novo com backoff e o mesmo id.
Referência completa em Disparar uma função pela API.
Isso foi útil?
Ainda precisa de ajuda? Pergunte à equipe