> For the complete documentation index, see [llms.txt](https://docs.skail.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skail.dev/construir/api-http.md).

# API HTTP

A API HTTP é a única forma de iniciar uma function e de disparar um evento externo. Dois `POST`, dois headers, qualquer linguagem.

* [Autenticação e headers](/construir/api-http/autenticacao-e-headers.md). Toda chamada à API HTTP do skail leva dois headers: a chave do environment e o namespace. Esta página é a referência deles e da URL base.
* [POST /trigger/{workload}/{versao}/{funcao}/{id}](/construir/api-http/post-trigger-workload-versao-funcao-id.md). Inicia a execução de uma `[SkailFunction]`. É a porta de entrada de todo fluxo durável: a partir daqui, o skail assume a execução.
* [POST /api/v1/fire/{eventName}/{instanceId}](/construir/api-http/post-api-v1-fire-eventname-instanceid.md). Dispara um evento externo. A execução que estiver parada em `SkailTask.WaitForEvent` com o mesmo nome e o mesmo instance id é acordada e recebe o corpo como payload.
* [Demais rotas](/construir/api-http/demais-rotas.md). As rotas públicas da API HTTP são duas: o trigger e o fire. Esta página diz como resolver, com elas, o que outras APIs resolveriam com rotas a mais.