REST API v1 and OAuth
Authenticate with API keys and scopes, follow the API conventions, create leads and draft invoices, and understand the OAuth 2.1 + PKCE app sign-in.
Уроки
Уроки для разработчиков написаны на английском: код, названия API и имена файлов везде на английском.
- API keys and scopesHow keys are created and sent, which scopes exist, and what the API answers when a key is missing, wrong or too weak.около 7 мин
- API conventions: money, lists, errors and limitsMinor-unit money, pagination and filters, the error shape, rate limits, Idempotency-Key and the headers on every answer.около 8 мин
- The resources of API v1Which endpoints exist, what they do and which scope each needs — including the hosted-only and app-only ones.около 6 мин
- Create a lead and a draft invoiceTwo real write calls with curl and with TypeScript fetch, including an Idempotency-Key for safe retries.около 10 мин
- OAuth 2.1 + PKCE app sign-inHow the zmle mobile and desktop apps sign in: discovery, authorization code with S256 PKCE, rotating refresh tokens and revocation.около 10 мин
- The reference page and the OpenAPI documentUse /api/v1/docs to browse and /api/v1/openapi.json to generate a typed client, and read the API request log when something fails.около 5 мин