مرجع › مستندات Jev
خطاها و محدودیت نرخ
خطاها از کدهای وضعیت استاندارد HTTP با بدنهی JSON توصیفی استفاده میکنند.
| وضعیت | معنا |
|---|---|
401 Unauthorized | کلید API موجود نیست یا نامعتبر است. هدر Authorization را بررسی کنید. |
422 Unprocessable Entity | بدنهی درخواست اعتبارسنجی نشد؛ مثلاً فیلد الزامی جا افتاده یا پرسش بدشکل است. بدنهی پاسخ فیلد مشکلدار را مشخص میکند. |
429 Too Many Requests | از محدودیت نرخ گذشتهاید. کمی صبر کنید و دوباره تلاش کنید. |
529 Overloaded | TypeSafe موقتاً پربار است. پس از کمی تأخیر دوباره تلاش کنید. |
مدیریت محدودیت نرخ
با دریافت 429 یا 529، بهجای تلاش فوری، با exponential backoff دوباره تلاش کنید. SDKهای کلاینت این کار را خودکار انجام میدهند؛ اگر از SDK با سیاست پیشفرض retry استفاده میکنید نیازی به مدیریت اضافه نیست.
کلاسهای خطای SDK
| وضعیت | Python | JavaScript |
|---|---|---|
| 400 | TypeSafeBadRequestError | BadRequestError |
| 401 | TypeSafeAuthenticationError | AuthenticationError |
| 403 | TypeSafePermissionDeniedError | PermissionDeniedError |
| 404 | TypeSafeNotFoundError | NotFoundError |
| 422 | TypeSafeUnprocessableEntityError | UnprocessableEntityError |
| 429 | TypeSafeRateLimitError (retry_after_ms) | RateLimitError |
| 5xx | TypeSafeInternalServerError | InternalServerError |
| پایه | TypeSafeError → TypeSafeAPIError | TypeSafeError → APIError |
در پایتون، TypeSafeAPIError فیلدهای status، body، headers، endpoint و ویژگی request_id (هدر x-typesafe-request-id) دارد.