Skip to main content

Best Practices

An expanded guide is coming soon. The essentials, each covered in more depth elsewhere:

  • Keep credentials server-side. They are not usable from a browser — see Authentication.
  • Handle 204 on empty lists. An empty result has no body at all — see Conventions.
  • Treat creation as asynchronous. A 2xx means accepted, not finished. Poll status, or subscribe to webhooks.
  • Retry only what is retryable. 5xx and timeouts, never 4xx — see Error Handling.
  • Pace your calls. Bound concurrency and back off with jitter — see Rate Limits.
  • Check credits before bulk work. Creation costs credits and fails with 402 — see Credits & Billing.