<!-- https://www.akrus.digital/docs/api · revisado em 2026-10-08 · gerado do mesmo conteúdo da página HTML -->
_Referência da API · v1 em prévia_

# Três recursos. Somente leitura.

A v1 expõe coleções de produtos, vendas e concessões de acesso vinculadas ao produtor da credencial.

> **Antes de integrar**
>
> Contrato em prévia. A implementação foi validada localmente; a liberação em produção ainda precisa ser confirmada pela equipe. O acesso programático exige plano Scale efetivo, credencial e escopos autorizados. Solicite acesso e a URL do ambiente antes de integrar.
>
> [Ver disponibilidade](https://www.akrus.digital/docs/ambientes)

## Recursos

Coleções em ordem decrescente pelo campo de ordenação, com desempate por id.

| Recurso | Método e rota | Escopo | Ordenação |
| --- | --- | --- | --- |
| Produtos | GET /api/v1/products | products:read | created_at |
| Vendas | GET /api/v1/sales | sales:read | created_at |
| Acessos | GET /api/v1/access | access:read | granted_at |

## Envelope de sucesso

A resposta usa Cache-Control: no-store. Percorra a coleção com limit e cursor. Apenas os campos documentados fazem parte da resposta.

```json
{ "data": [], "next_cursor": null, "version": "v1" }
```

## Convenções de consumo

### Requisição

- [ ] Use HTTPS no ambiente autorizado e envie Authorization em cada chamada.
- [ ] Não use endpoints internos do painel como extensão deste contrato.

### Resposta

- [ ] Trate identificadores como strings, valores monetários em centavos e datas como timestamps com fuso.
- [ ] Preserve null; ele não equivale a zero, string vazia ou data atual.
- [ ] Tolere campos adicionais e trate estados desconhecidos sem quebrar a aplicação.

> **Limites do contrato**
>
> Criação de produtos, cobrança, saque, identificação de compradores e rotas internas do painel não fazem parte desta referência. A v1 não oferece operações de escrita documentadas.

## Consulte cada recurso

- [API de produtos](https://www.akrus.digital/docs/api/produtos) — GET /api/v1/products · products:read.
- [API de vendas](https://www.akrus.digital/docs/api/vendas) — GET /api/v1/sales · sales:read.
- [API de acessos](https://www.akrus.digital/docs/api/acessos) — GET /api/v1/access · access:read.

---

Anterior: [Ambientes e disponibilidade](https://www.akrus.digital/docs/ambientes) · Próximo: [API de produtos](https://www.akrus.digital/docs/api/produtos)
