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

# Lojou Developer

> Referência oficial da API v1 da Lojou.

A API da Lojou permite criar produtos, processar pedidos, gerenciar planos de assinatura e receber webhooks de eventos de uma loja — tudo o que você precisa pra integrar um app externo com uma loja Lojou.

<CardGroup cols={2}>
  <Card title="Comece em 5 minutos" icon="rocket" href="/pt/quickstart">
    Gere uma API Key e faça a sua primeira chamada.
  </Card>

  <Card title="Autenticação" icon="key" href="/pt/authentication">
    API Key ou OAuth — como funciona cada uma.
  </Card>

  <Card title="Conectar via OAuth" icon="plug" href="/pt/oauth">
    Pra apps que outros vendedores vão instalar na própria loja.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/pt/webhooks">
    O payload exato que a Lojou envia, e quando.
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference">
    Todos os endpoints, parâmetros e respostas.
  </Card>
</CardGroup>

## URL base

```
https://api.lojou.app
```

## Versão

Todos os endpoints documentados aqui usam o prefixo `/v1`.

## Dois jeitos de autenticar

* **API Key** — pra integrar a sua própria loja. Gere em `Configurações → API` no painel da Lojou.
* **OAuth** — pra construir um app que outros vendedores vão instalar e autorizar na loja deles. Veja o [guia de OAuth](/pt/oauth).

Os dois usam o mesmo header:

```http theme={null}
Authorization: Bearer <token>
```

## Formato de resposta

Toda resposta da API segue o mesmo formato:

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

Erros seguem o mesmo padrão, com `status: "error"`:

```json theme={null}
{
  "status": "error",
  "message": "Permission denied for this endpoint.",
  "error_code": "insufficient_scope"
}
```

## Precisa de ajuda?

Fale com o suporte da Lojou pelo painel, ou chame `GET /v1/scopes` (documentado na [referência da API](/api-reference)) pra ver exatamente o que o seu token pode fazer.