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 — body or parameter validation failed.
401Unauthorized — API key is missing or invalid.
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).
429Too Many Requests — rate limit exceeded, wait for Retry-After.
500Server Error — an unexpected condition occurred, retry.