D1VD1V

API

How to explore endpoints, authenticate, paginate, and handle webhooks safely.

OpenAPI

Use the in-app viewer for exact schemas and parameters:

  • [OpenAPI viewer](/openapi)

Auth & headers

Authorization: Bearer <YOUR_TOKEN>
Content-Type: application/json

Response & errors

Common envelope:

{
  "code": 0,
  "msg": "OK",
  "data": {}
}
  • code === 0 usually indicates success.
  • Some endpoints may also return a detail field for validation-style errors.

Pagination & filtering

Follow OpenAPI per endpoint. Common patterns:

  • ?limit=20&offset=0
  • ?page=1&page_size=20

Filtering is typically done with query params, for example: ?environment=dev

Webhooks

ClientAPIDB

Webhook rules

  1. Verify signatures
  2. Enforce idempotency by event id
  3. Expect duplicates (at-least-once delivery)

Rate limits & retries

  • For 429, back off with exponential delays and jitter.
  • For 5xx, retry carefully and log useful fields (code, msg, detail).

See also

Getting Started · Integrations · API