> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/funcionamento/guia-rapido.md).

# Guia Rápido

Este guia leva você do **zero** à sua **primeira chamada bem-sucedida** à API, em poucos minutos.

## 1️⃣ Obtenha o Token e o Identificador da Loja

No painel da loja, acesse **Sistema → Configurações Gerais → API de Acesso Externo → Atualizar Token** e copie o **Identificador** e o **Token**.

O passo a passo completo, com telas, está em:

{% content-ref url="/pages/-MObk4z78qnd5Uc2I2C4" %}
[Geração de Token](/funcionamento/geracao-de-token.md)
{% endcontent-ref %}

## 2️⃣ Monte a primeira requisição

Toda requisição precisa de dois headers de autenticação:

```
Authorization: Bearer [Token]
Loja: [Identificador de Sua Loja]
```

Vamos testar o endpoint `/status/`, que serve justamente para verificar se a API está disponível e se sua autenticação está correta:

```bash
curl -X GET "https://api.toplojas.com.br/status/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

Substitua `[Token]` e `[Identificador de Sua Loja]` pelos valores obtidos no passo 1.

## 3️⃣ Interprete a resposta

Se tudo estiver correto, a API responde com o HTTP Code **204** (sucesso, sem conteúdo). Isso significa que sua loja está autenticada e pronta para usar a API.

Se receber um erro, consulte:

{% content-ref url="/pages/SYlZNpYxy5JUMvCVzaSQ" %}
[Solução de Problemas](/funcionamento/solucao-de-problemas.md)
{% endcontent-ref %}

## ✅ Próximos passos

Agora que sua autenticação funciona, explore os módulos:

* 🛒 [Pedidos](/pedidos/visao-geral.md) — consultar e gerenciar pedidos
* 📦 [Produtos](/produtos/visao-geral.md) — cadastrar e gerenciar produtos e estoque
* 🔔 [Webhook](/funcionamento/webhook.md) — receber notificações automáticas de eventos

{% hint style="info" %}
Prefere testar sem escrever código? Use o [Simulador Online](/funcionamento/utilizando-o-simulador-online.md) ou configure o [Postman](/funcionamento/configurando-o-postman.md).
{% endhint %}

{% hint style="info" %}
Lembre-se dos limites e padrões da API (limite de requisições, formato de datas e decimais) descritos em [Considerações Gerais](/funcionamento/consideracoes-gerais.md).
{% endhint %}