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