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

# Introdução

> Entenda conceitos, pré-requisitos e funcionamento da API Cakto.

## Visão Geral

A API Cakto é uma API REST que permite integrar sua aplicação com a plataforma Cakto, possibilitando o gerenciamento via código de produtos, ofertas, pedidos e outras funcionalidades.

### URL Base

Todas as requisições devem ser feitas utilizando esta URL base:

```bash theme={null}
https://api.cakto.com.br/
```

## Pré-requisitos

Para começar a usar a API, você precisa:

1. **Conta na Cakto** - Uma conta ativa na plataforma, cadastre-se [aqui](https://app.cakto.com.br/auth/register).
2. **Chaves de API** - `client_id` e `client_secret` gerados no [Painel Cakto](https://app.cakto.com.br/dashboard/cakto-api)
3. **Token de Acesso** - Obtido via [autenticação OAuth2](/authentication)

Veja como gerar suas chaves e obter o token de acesso no guia completo de autenticação:

<Card title="Guia Completo de Autenticação" icon="key" href="/authentication">
  Passo a passo para criar suas chaves e autenticar, com exemplos de código.
</Card>

## Formato das Requisições

Todas as requisições autenticadas utilizam o header HTTP `Authorization`.

```http theme={null}
Authorization: Bearer {seu_access_token}
Content-Type: application/json
```

## Paginação e Filtros

Endpoints de listagem suportam parâmetros de URL para paginação, busca, filtros e ordenação:

```bash theme={null}
# Paginação
?page=2&limit=50

# Busca
?search=curso

# Filtros
?status=active&type=unique

# Ordenação
?ordering=-price
```

## Formato das Respostas

As respostas retornam dados em formato JSON. Listagens são sempre paginadas:

```json theme={null}
{
  "count": 42,
  "next": "https://api.cakto.com.br/api/products/?page=4",
  "previous": "https://api.cakto.com.br/api/products/?page=2",
  "results": [...]
}
```

### Códigos de Status HTTP

| Código | Descrição            |
| ------ | -------------------- |
| 200    | Sucesso              |
| 201    | Recurso criado       |
| 204    | Sucesso sem conteúdo |
| 400    | Requisição inválida  |
| 401    | Não autenticado      |
| 403    | Sem permissão        |
| 404    | Não encontrado       |

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Cakto SDK" icon="cube" href="/sdk/visao-geral">
    Tokenize cartões, 3DS e antifraude no browser
  </Card>

  <Card title="Referência da API" icon="book" href="/api-reference/products/list">
    Explore todos os endpoints disponíveis
  </Card>

  <Card title="Suporte" icon="life-ring" href="mailto:infoprodutores@cakto.com.br">
    Entre em contato com nossa equipe
  </Card>
</CardGroup>