> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flunora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução à API

> O que é público na API da Flunora hoje, e o que fica dentro do produto.

A superfície pública da Flunora é deliberadamente pequena. Ela cobre **entrada de
contatos**: os caminhos pelos quais um sistema externo coloca alguém no seu funil.

<Card title="Webhook de entrada" href="/api/webhook-de-entrada" horizontal>
  Uma URL por webhook, autenticada por token, que cria um contato a partir de JSON ou de
  um formulário HTML.
</Card>

## URL base

A URL base é o endereço da **sua instância**, não um domínio compartilhado da
plataforma:

```
https://crm.suaempresa.com
```

Todo endereço nesta referência é relativo a ele. Se a sua instância ainda usa o
subdomínio provisório da implantação, use esse.

## O que não é público

O resto da plataforma responde a rotas autenticadas por sessão, feitas para o produto e
não para integração de terceiros. Elas não têm compromisso de estabilidade e podem mudar
sem aviso, então não construa em cima delas.

<Note>
  Se a sua operação precisa de leitura programática do funil, escreva para
  [contato@flunora.com.br](mailto:contato@flunora.com.br) descrevendo o caso. É o tipo de
  coisa que entra no roteiro por demanda real, não por especulação.
</Note>

## Sem SDK

Não há biblioteca cliente, e não faz falta: a superfície é uma requisição HTTP com um
corpo simples. Os exemplos desta referência cobrem `curl`, JavaScript, PHP, Python e
formulário HTML puro.

## Convenções

<ResponseField name="Formato" type="JSON">
  As respostas são sempre JSON. O corpo da requisição pode ser JSON, formulário
  codificado ou multipart.
</ResponseField>

<ResponseField name="Codificação" type="UTF-8">
  Acentos e cedilha são esperados e não precisam de escape.
</ResponseField>

<ResponseField name="Origem" type="CORS liberado">
  Os endereços de entrada aceitam requisição de qualquer origem, o que permite chamar
  direto do navegador de uma página de captura.
</ResponseField>