Errors

The Stokzone API uses standard HTTP status codes. Error responses return in a consistent JSON format.

Error format

All error responses include a detail field carrying a human-readable message:

JSON
{
  "detail": "İstek gövdesi doğrulanamadı"
}

HTTP status codes

CodeMeaning
200OK — the request completed successfully.
201Created — a new record was created successfully.
400Bad Request — the body could not be read (e.g. malformed JSON) or a parameter is malformed.
401Unauthorized — API key is missing or invalid.
402Payment Required — your workspace plan does not include API access (the apiAccess package).
403Forbidden — the key lacks the required scope or the IP is restricted.
404Not Found — the requested record does not exist.
409Conflict — the record conflicts with current state (e.g. duplicate SKU).
422Unprocessable Entity — field validation failed (a required field is missing or a type/format is invalid).
429Too Many Requests — rate limit exceeded, wait for Retry-After.
500Server Error — an unexpected condition occurred, retry.
502Bad Gateway — the marketplace/upstream could not complete the operation (e.g. return approval/rejection, answering a question). May be transient, retry.