خطاهای رایج
کدهای خطا، وضعیت HTTP و توضیحات مربوط به پاسخ‌های Open API.
همه‌ی خطاها به شکل { code, message, statusCode } بازگردانده می‌شوند.
| کد | وضعیت | توضیح |
|---|---|---|
AUTH_HEADERS_MISSING |
401 | یکی از هدرهای X-API-Key، X-Timestamp یا X-Signature ارسال نشده است. |
TIMESTAMP_INVALID |
401 | زمان درخواست منقضی شده یا نامعتبر است — بازه‌ی مجاز ۵ دقیقه است. |
API_KEY_INVALID |
401 | کلید API نامعتبر یا غیرفعال است. |
SIGNATURE_INVALID |
401 | امضای HMAC با محتوای درخواست مطابقت ندارد. |
ADVANCED_KYC_NEEDED |
403 | احراز هویت پیشرفته حساب شما تکمیل نشده است. |
INSUFFICIENT_PERMISSIONS |
403 | کلید API شما دسترسی لازم برای این عملیات را ندارد. |
IP_NOT_WHITELISTED |
403 | آدرس IP درخواست در فهرست مجاز این کلید نیست. |
ADDRESS_NOT_VERIFIED |
403 | آدرس مقصد برداشت، در فهرست آدرس‌های تأییدشده‌ی شما ثبت نشده است. |
RATE_LIMIT_EXCEEDED |
429 | تعداد درخواست‌ها از سقف مجاز عبور کرده است. |