Desenvolvedores
Documentação de endpoint REST a partir de uma especificação de rota
Documentação consistente no estilo OpenAPI para cada endpoint, sem copia-e-cola
Ver prévia de entrada e saída
Entrada
- Method
- POST
- Path
- /v1/invoices
- Summary
- Create a draft invoice
- Auth
- Bearer token
Saída (trecho)
### POST /v1/invoices
Cria uma fatura em rascunho para um cliente. Rascunhos podem ser finalizados depois via `POST /v1/invoices/{id}/finalize`.
**Autenticação:** token Bearer (escopo: `invoices:write`).
**Corpo da requisição:**
```json
{ "customer_id": "cus_123", "currency": "usd", "line_items": [{"description": "Contrato Q3", "amount": 250000}] }
```
**Resposta 201:** o objeto Invoice completo com `status: "draft"`. **400** se faltar o customer_id. **402** quando o cliente tem faturas em atraso. **429** com o cabeçalho `Retry-After` acima de 100 req/min.
