Referensi & Pemecahan Masalah

Kode Kesalahan dan Pemecahan Masalah

View as Markdown

Format Respons Kesalahan

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

Kesalahan bisnis biasanya masih mengembalikan struktur JSON yang terpadu. Integrator harus memeriksa code terlebih dahulu. Kegagalan autentikasi dapat mengembalikan HTTP 401; Pembatasan tarif dapat mengembalikan HTTP 429.

Kode Kesalahan Umum

Kode kesalahanDeskripsi
0Keberhasilan
1001Tidak ada informasi autentikasi yang valid yang diberikan
1002Token kedaluwarsa
1003Token, API Key, atau tanda tangan tidak valid
1004Token dicabut
1006Ketidakcocokan sumber IP
2001Parameter yang dibutuhkan hilang
2002Nilai parameter tidak valid
2003Parameter di luar jangkauan
3001Keseimbangan yang tidak memadai
3003Pesanan tidak ditemukan
3004Permintaan duplikat
3005Pesanan tidak dapat dibatalkan
3006Izin ditolak
3100 - 3112Kesalahan validasi parameter urutan kondisi
5001Kesalahan server internal
5002Layanan sementara tidak tersedia
5003Batas laju dipicu

Pemecahan Masalah

MasalahRekomendasi
1001 tidak ada informasi autentikasi yang validPeriksa apakah Authorization: Bearer <accessToken> atau X-API-KEY termasuk.
1002 Token kedaluwarsaSegarkan Token atau masuk lagi sebelum mencoba lagi.
1003 Token, API Key, atau tanda tangan yang tidak validPeriksa API Key, payload tanda tangan, isi permintaan JSON string, dan urutan parameter kueri.
1006 sumber IP ketidakcocokanPeriksa konfigurasi daftar putih API Key IP .
3004 permintaan duplikatJangan gunakan ulang tanda tangan yang sama untuk jalur terkait pesanan. Regenerasi timestamp dan signature.
batas tarif 5003 diaktifkanKurangi frekuensi permintaan dan gunakan backoff eksponensial jika mencoba ulang.
Timestamp outside of tolerance windowHubungi /v1/time untuk mengkalibrasi offset waktu dan menandatangani permintaan lagi.