API conventions

Base URL, response envelopes, URL encoding, and safe retries.

Base URL#

text

https://tringify-custom-products.developers-c8a.workers.dev

Response envelopes#

json


{
  "success": true,
  "data": {}
}

json


{
  "success": false,
  "error": {
    "code": "PRODUCTION_FILE_NOT_READY",
  	"message": "The production file is not ready yet."
  }
}

Branch on error.code, not on error.message. Order numbers are URL-encoded path segments; for example, #STICKER100006 is sent as %23STICKER100006. Cursors are opaque: return next_cursor unchanged in the next request.

Safe retries#

These endpoints are read-only. Retry transient 503 responses with backoff. Do not retry 401, 403, 404, 409, or 410 without first applying the condition named by the error code.