Documentação de endpoint REST a partir de uma especificação de rota
Documentação consistente ao estilo OpenAPI para cada endpoint sem copiar e colar
Ver pré-visualização de entrada e saída
Entrada
- Tipo de Autenticação
- Chave de API
- Informação da API
- Create a draft invoice
Saída (excerto)
### POST /v1/invoices
Cria uma fatura em rascunho para um cliente. Os rascunhos podem ser finalizados mais tarde via `POST /v1/invoices/{id}/finalize`.
**Autenticação:** token Bearer (âmbito: `invoices:write`).
**Corpo do pedido:**
```json
{ "customer_id": "cus_123", "currency": "usd", "line_items": [{"description": "Avença do Q3", "amount": 250000}] }
```
**Resposta 201:** o objeto Invoice completo com `status: "draft"`. **400** se faltar o customer_id. **402** quando o cliente tem faturas vencidas. **429** com cabeçalho `Retry-After` acima de 100 pedidos/min.