Посилання та усунення несправностей

Коди помилок та усунення несправностей

View as Markdown

Формат відповіді на помилки

1{
2  "code": 1003,
3  "message": "Invalid token",
4  "requestId": "req-12345678"
5}

Бізнес-помилки зазвичай все одно повертають уніфіковану структуру JSON . Інтегратори повинні спочатку перевірити code . Невдачі автентифікації можуть повернути HTTP 401; обмеження швидкості може повернути HTTP 429.

Поширені коди помилок

Код помилкиОпис
0Успіх
1001Не надано дійсної інформації про автентифікацію
1002Токен закінчився
1003Недійсний токен, API Keyабо підпис
1004Жетон анульовано
1006Джерело IP невідповідність
2001Відсутній необхідний параметр
2002Недійсне значення параметра
2003Параметр поза зоною дії
3001Недостатній баланс
3003Порядок не знайдено
3004Дублікатний запит
3005Замовлення не можна скасувати
3006Дозвіл відмовлено
3100 - 3112Помилка валідації параметра порядку стану
5001Помилка внутрішнього сервера
5002Тимчасово недоступна послуга
5003Спрацювано ліміт ставки

Усунення несправностей

ПроблемаРекомендація
1001 немає достовірної інформації про автентифікаціюПеревірте, чи входить Authorization: Bearer <accessToken> чи X-API-KEY .
1002 Токен закінчивсяОновіть токен або увійдіть ще раз перед повторною спробою.
1003 недійсний токен, API Keyабо підписПеревірте API Key, корисне навантаження підпису, тіло запиту JSON рядок і порядок параметрів запиту.
1006 джерело IP невідповідністьПеревірте конфігурацію API Key IP білого списку.
3004 дубльований запитНе використовуйте один і той самий підпис для шляхів, пов’язаних із порядком. Регенеруйте timestamp і signature.
5003 ліміт ставки активованоЗменшуйте частоту запитів і використовуйте експоненціальний відкат при повторній спробі.
Timestamp outside of tolerance windowЗателефонуйте /v1/time , щоб відкалібрувати зсув за часом, і знову підпишіть запит.