API Introduction

Base URL

Every request is made against the versioned base URL:

# All endpoints are mounted under /v1
curl https://api.onlucra.com/v1

The service root returns metadata about the API version and the available public routes.

Response envelope

Every response uses the same envelope. Successful requests return the resource under data:

{
  "data": { "...": "..." },
  "ok": true
}

Failed requests return an error object instead — see Errors & limits for the codes.

{
  "error": {
    "code": "not_found",
    "message": "Route not found."
  },
  "ok": false
}

All responses are application/json; charset=utf-8 and are never cached (cache-control: no-store).