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

# API Reference

> Documentação completa da API pública do Tartini.

export const Artigo = ({titulo, href, children}) => <a className="lista-artigos-item" href={href}>
    <span className="lista-artigos-texto">
      <span className="lista-artigos-nome">{titulo}</span>
      {children ? <span className="lista-artigos-desc">{children}</span> : null}
    </span>
    <svg className="lista-artigos-seta" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">
      <path d="M9 6l6 6-6 6" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
    </svg>
  </a>;

export const Lista = ({titulo, children}) => <div className="lista-artigos">
    {titulo ? <p className="lista-artigos-titulo">{titulo}</p> : null}
    <div className="lista-artigos-itens">{children}</div>
  </div>;

A API pública do Tartini permite integrar funcionalidades de inteligência artificial e base de conhecimento a sistemas externos: chatbots, CRMs, aplicações web e mais.

## Base URL

Todas as requisições devem ser feitas para:

```
https://api-talk.saninternet.com/v1
```

## Autenticação

Todas as requisições exigem uma API key válida enviada no header `Authorization`:

```
Authorization: Bearer pyp_live_SUA_API_KEY
```

<Note>
  API keys são geradas no [Dashboard](https://talk.saninternet.com) em **Configurações > API Keys**. Veja o guia completo em [Autenticação](/concepts/authentication).
</Note>

## Endpoints disponíveis

<Lista>
  <Artigo titulo="GET /api/status" href="/api-reference/endpoint/status">Verifica se a API está operacional e valida sua API key.</Artigo>
  <Artigo titulo="POST /api/rag/retrieve" href="/api-reference/endpoint/rag-retrieve">Busca chunks relevantes e gera respostas com IA.</Artigo>
</Lista>

## Formato de resposta

Todas as respostas são retornadas em JSON. Em caso de erro:

```json theme={null}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Invalid or expired API key"
}
```

## Códigos de status

| Código | Descrição                                   |
| ------ | ------------------------------------------- |
| `200`  | Sucesso                                     |
| `401`  | API key ausente, inválida ou expirada       |
| `403`  | Assinatura inativa (`SubscriptionInactive`) |
| `422`  | Erro de validação no corpo da requisição    |


## Related topics

- [Conexão via API](/desenvolvedores/conexao-via-api.md)
- [Status da API](/api-reference/endpoint/status.md)
- [Conecte o WhatsApp Business API (WABA)](/canais/whatsapp-business-api.md)