Pular para o conteúdo principal
Execuções

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/json

O 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.