Errors

{
  "type": "https://docs.furniops.com/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "The standard.read budget is spent. Retry after 1 s.",
  "request_id": "req_034XqBaL2mRLTZPXyRbaUl",
  "doc_url": "https://docs.furniops.com/errors/rate_limited"
}

{
  "type": "https://docs.furniops.com/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "The cursor is not one this list issued",
  "request_id": "req_034XqBaL2mRLTZPXyRbaUm",
  "doc_url": "https://docs.furniops.com/errors/invalid_request",
  "errors": [
    {
      "path": "starting_after",
      "code": "invalid_cursor",
      "message": "Must be a cursor from this list"
    }
  ]
}

try {
  await furniops.products.get("prod_034XqBaL2mRLTZPXyRbaUc");
} catch (error) {
  if (error instanceof NotFoundError) {
    // 404: no such product, or not one this key may see.
  } else if (error instanceof ValidationError) {
    // 400, 413, 415, 422, 428: fix the request; problem.errors names the fields.
    for (const field of error.problem?.errors ?? []) console.log(field.path, field.code);
  } else if (error instanceof RateLimitError) {
    // 429 after the retries, or a Retry-After longer than 60 s.
    console.log("retry in", error.retryAfterMs, "ms");
  } else if (error instanceof AuthenticationError || error instanceof PermissionError) {
    // 401: no key, or a bad one. 403: the key lacks the scope, or test mode is required.
  } else if (error instanceof ConflictError) {
    // 409 or 412: a state or version conflict.
  } else if (error instanceof ConnectionError) {
    // No response at all (TimeoutError is one), after the retries.
  }
  if (error instanceof FurniOpsError) {
    // Every SDK error: quote requestId to support.
    console.error(error.status, error.code, error.requestId, error.message);
  }
}