Programiści
Dokumentacja endpointu REST ze specyfikacji trasy
Spójna dokumentacja w stylu OpenAPI dla każdego endpointu bez kopiuj-wklej
Zobacz podgląd danych wejściowych i wyjściowych
Dane wejściowe
- Method
- POST
- Path
- /v1/invoices
- Summary
- Create a draft invoice
- Auth
- Bearer token
Wynik (fragment)
### POST /v1/invoices
Tworzy szkic faktury dla klienta. Szkice można później sfinalizować przez `POST /v1/invoices/{id}/finalize`.
**Autoryzacja:** token Bearer (zakres: `invoices:write`).
**Treść żądania:**
```json
{ "customer_id": "cus_123", "currency": "usd", "line_items": [{"description": "Retainer Q3", "amount": 250000}] }
```
**Odpowiedź 201:** pełny obiekt Invoice ze `status: "draft"`. **400** przy braku customer_id. **402**, gdy klient ma zaległe faktury. **429** z nagłówkiem `Retry-After` powyżej 100 żądań/min.
