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 分钟