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

# API Reference

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

A API pública do Talk AI 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

<CardGroup cols={2}>
  <Card title="GET /api/status" icon="signal" href="/api-reference/endpoint/status">
    Verifica se a API está operacional e valida sua API key.
  </Card>

  <Card title="POST /api/rag/retrieve" icon="magnifying-glass" href="/api-reference/endpoint/rag-retrieve">
    Busca chunks relevantes e gera respostas com IA.
  </Card>
</CardGroup>

## 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    |