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

# Comece em 5 minutos

> Da API Key até a sua primeira chamada.

## 1. Gere uma API Key

No painel da Lojou: **Configurações → API → Nova API Key**. Escolha os escopos que você precisa (ex: `orders.read`, `products.write`) e copie a chave — ela só é exibida uma vez.

<Tip>
  Se você está construindo um app pra OUTROS vendedores instalarem (não só pra sua própria loja), use [OAuth](/pt/oauth) em vez de uma API Key fixa.
</Tip>

## 2. Teste a conexão

```bash theme={null}
curl https://api.lojou.app/v1/ping
```

```json theme={null}
{ "status": "success", "message": "pong" }
```

Esse endpoint não exige autenticação — é só pra confirmar que a API está no ar.

## 3. Confirme quem você é

```bash theme={null}
curl https://api.lojou.app/v1/user \
  -H "Authorization: Bearer SUA_API_KEY"
```

Se voltar `401`, a chave está errada ou expirou. Se voltar `403`, a chave existe mas não tem o escopo `user.read` — veja [Autenticação](/pt/authentication#escopos).

## 4. Liste os seus produtos

```bash theme={null}
curl https://api.lojou.app/v1/products \
  -H "Authorization: Bearer SUA_API_KEY"
```

```json theme={null}
{
  "status": "success",
  "page": 1,
  "per_page": 20,
  "last_page": 1,
  "total": 3,
  "data": [ ]
}
```

## 5. Crie um pedido

Todo pedido precisa de `amount`, `product_pid` e `customer`:

```bash theme={null}
curl -X POST https://api.lojou.app/v1/orders \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500,
    "product_pid": "PROD-ABC123",
    "customer": {
      "name": "Maria Silva",
      "email": "maria@exemplo.com",
      "mobile_number": "+258840000000"
    }
  }'
```

A resposta traz `checkout_url` — é o link que você manda pro cliente pra ele concluir o pagamento.

## Próximo passo

* [Receba eventos em tempo real](/api-reference) configurando um webhook (`POST /v1/webhooks`) em vez de ficar consultando o pedido.
* Construindo um app pra outros vendedores? Veja o [guia de OAuth](/pt/oauth).