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 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 دقيقة