کدهای خطا¶
هر کدی که کتابخانه خودش میفرستد. کلاینت بر اساس اینها تصمیم میگیرد، هرگز
بر اساس پیام. هر کدام با ERROR_CODES قابل تغییر اسم
است.
| وضعیت | error_code |
از کجا | data |
|---|---|---|---|
| 400 | validation_error |
serializer، ValidationError خود Django، InvalidInputError |
fields: همهی مشکلها، بر اساس مسیر تخت فیلدشان |
| 400 | parse_error |
بدنهای که JSON معتبر نیست | {} |
| 400 | invalid_cursor |
cursorی که سرور نمیتواند بخواند، دستی عوض شده، با کلید دیگری امضا شده، یا برای ترتیب دیگری ساخته شده | {} |
| 401 | not_authenticated |
اطلاعات ورود فرستاده نشده. 403، همانطور که DRF جواب میدهد، وقتی اولین کلاس احراز هویت view هدر WWW-Authenticate نمیفرستد - احراز هویت با session |
{} |
| 401 | authentication_failed |
اطلاعات ورود اشتباه یا منقضی | {} |
| 403 | permission_denied |
PermissionDenied در DRF یا Django، با جملهای که با آن raise شده |
{} |
| 404 | not_found |
NotFound، یا Http404 خود Django - بدون گفتن اینکه چه چیزی جستجو شده |
{} |
| 405 | method_not_allowed |
متدی که view ندارد؛ Allow میگوید کدامها را دارد |
{} |
| 406 | not_acceptable |
Acceptی که هیچ چیز نمیتواند جوابش را بدهد |
{} |
| 409 | already_exists |
قید unique، با HANDLE_INTEGRITY_ERRORS |
{} |
| 409 | conflict |
قید foreign key، با HANDLE_INTEGRITY_ERRORS؛ ConflictError |
{} |
| 415 | unsupported_media_type |
بدنهای از نوعی که view نمیخواند | {} |
| 429 | rate_limited |
محدودیت تعداد درخواست؛ Retry-After همان را میگوید |
retry_after، به ثانیه |
| 500 | internal_error |
هر چیزی که کسی طراحیاش نکرده - و مثل هر 5xx دیگری، لاگ و گزارش میشود | {} |
| 503 | service_unavailable |
ServiceUnavailableError |
{} |
خطای خود پروژه default_code خودش را میفرستد، و dataای که با آن raise
شده - و هرگز تغییر اسم نمیدهد.
data.fields¶
{"name": [{"code": "required", "message": "This field is required."}],
"items.0.quantity": [{"code": "min_value", "message": "Ensure this value is greater than or equal to 1."}],
"non_field_errors": [{"code": "invalid", "message": "The dates are the wrong way round."}]}
code هر مشکل همان کد خود DRF یا Django است: required، blank، null،
invalid، max_length، min_length، max_value، min_value، unique،
does_not_exist، incorrect_type، invalid_choice و بقیه - یا کدی که
validator پروژه با آن raise کرده.
مسیر، اسم فیلدهاست که با FIELD_PATH_SEPARATOR به هم وصل شدهاند. کلیدهای یک
DictField مال کلاینتاند، پس کلیدی که جداکننده را در خود دارد - "a.b" - مسیری
میسازد که شبیه یک فیلد تودرتو خوانده میشود؛ اگر کلیدهای پروژه ممکن است نقطه
داشته باشند، جداکنندهی دیگری انتخاب کنید.