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

# Introdução à API

> Visão geral da API Morada.ai — autenticação, base URLs e conceitos fundamentais.

## Visão Geral

A API da Morada.ai permite que parceiros integrem seus sistemas para criar e gerenciar deals, enviar notificações, ingerir leads e consultar produtos. A comunicação é feita via REST com payloads JSON.

## Base URLs

| Ambiente          | URL                                        |
| ----------------- | ------------------------------------------ |
| Gateway Principal | `https://mia-gateway.morada.ai`            |
| Integração (Logs) | `https://mia-integration.morada.ai/api/v1` |
| Plataforma (Talk) | `https://app.morada.ai`                    |

## Autenticação

A API utiliza dois métodos de autenticação dependendo do endpoint:

### API Key

Para endpoints de integração (deals, notificações, leads, produtos), envie a chave no header:

```bash theme={null}
curl -H "x-morada-api-key: SUA_CHAVE_API" \
  https://mia-gateway.morada.ai/deal
```

### Bearer Token

Para endpoints do Talk (autenticação, tickets), envie o token no header:

```bash theme={null}
curl -H "Authorization: Bearer SEU_TOKEN" \
  https://app.morada.ai/api/desk/tickets
```

## Formato de Resposta

Todas as respostas são retornadas em formato JSON. Em caso de sucesso, o status HTTP será `200`, `201` ou `202`. Em caso de erro:

```json theme={null}
{
  "statusCode": 400,
  "message": "Descrição do erro"
}
```

## Códigos de Erro Comuns

| Código | Descrição                                              |
| ------ | ------------------------------------------------------ |
| `400`  | Requisição inválida — verifique os parâmetros enviados |
| `401`  | Não autorizado — API key ou token inválido             |
| `404`  | Recurso não encontrado                                 |
| `500`  | Erro interno do servidor                               |

## Próximos Passos

<Columns cols={2}>
  <Card title="Criar Deal" icon="plus" href="/api-reference/endpoint/criar-deal">
    Crie um novo deal e inicie uma conversa no WhatsApp.
  </Card>

  <Card title="Enviar Notificação" icon="bell" href="/api-reference/endpoint/enviar-notificacao">
    Envie mensagens de template via WhatsApp.
  </Card>
</Columns>