Kode Kesalahan SDK MA iOS
Definisi Kode Kesalahan Klien
Dokumen ini berlaku untuk SDK MTMA mandiri v5.5.0 dan versi lebih baru.
| Code | Deskripsi | Penjelasan |
|---|---|---|
| 0 | Permintaan berhasil | Permintaan antarmuka berhasil |
| -1 | Permintaan gagal | Gangguan jaringan, format respons salah, fungsi MA dinonaktifkan dalam konfigurasi inisialisasi, atau kesalahan lain yang tidak diketahui |
| -2 | Permintaan gagal | start: belum dipanggil, MTMA belum berhasil diinisialisasi, atau MA AppKey, proyek, atau identitas telah berubah sebelum permintaan dalam antrean dijalankan |
| -3 | Pengaturan tidak valid | Validasi parameter gagal, misalnya MA AppKey tidak terdiri dari 24 huruf atau angka, atau tidak ada pengenal yang dapat digunakan setelah pembersihan pada identifyAccount: |
| -4 | Proyek ditutup | Antarmuka saat aplikasi berjalan mendeteksi MA dinonaktifkan, atau server mengembalikan kesalahan proyek ditutup; untuk MA yang dinonaktifkan dalam konfigurasi inisialisasi, lihat -1 |
| -5 | Dicadangkan untuk versi lama | Pada versi lama berarti registrasi AppPush belum berhasil; MTMA mandiri tidak lagi menggunakan kode ini |
| -6 | Proyek berganti | Proyek telah berganti; panggil kembali start: untuk inisialisasi |
| -7 | Permintaan sedang berjalan | Antarmuka yang tidak mendukung antrean sudah memiliki permintaan aktif. Pemanggilan start: yang valid tidak mengembalikan kode ini karena ada inisialisasi lain; permintaan kanal Push pihak ketiga diantrekan secara berurutan |
| -8 | Pengumpulan data nonaktif | CODE_COLLECTION_DISABLED, didukung mulai 5.5.1. Saat pengumpulan nonaktif, antarmuka penulisan properti pengguna tidak memperbarui data dan mengembalikan kode ini melalui callback |
Pengumpulan Data Nonaktif
-8 berlaku untuk semua antarmuka penulisan properti pengguna, termasuk operasi tunggal, massal, object, dan object_array. Saat pengumpulan nonaktif, pemanggilan antarmuka event dan UTM tanpa callback diabaikan, tanpa melempar exception.
Inisialisasi, pengenal pengguna, informasi kontak, dan antarmuka kanal tetap mengikuti aturan yang ada. Lihat konfigurasi, contoh pemanggilan, dan dampak pada API di Sakelar Pengumpulan Data.
Kode Bisnis Server
Tabel di atas memuat kode kesalahan yang dihasilkan SDK. Jika operasi bisnis gagal di server, SDK mengembalikan kode bisnis dan pesan terkait, sehingga callback dapat memuat code positif. Kode tertentu hanya untuk diagnosis dan tidak dijamin stabil antarversi. Jangan membuat percabangan logika bisnis berdasarkan kode tersebut.
Nilai hasil inisialisasi melalui MTMAInitResult.isSuccess; untuk antarmuka lain, code=0 menunjukkan permintaan berhasil. Jika terjadi kegagalan yang tidak diharapkan, berikan code dan message asli kepada dukungan teknis.
code=0dariidentifyAccount:tidak berarti semua pengenal berhasil diatur. Lihat Mengatur Pengenal Pengguna.- Jika properti object_array belum didefinisikan di server, operasi pada elemen dapat mengembalikan
code=0tanpa membuat perubahan. Lihat kondisi lain yang tidak mengubah data di Mengatur Properti Pengguna, dan pastikan hasil sebenarnya melalui konsol MA atau properti pengguna di server.
| Skenario | code pada Callback | message pada Callback |
|---|---|---|
Server mengembalikan kegagalan bisnis (HTTP 4xx/5xx, respons berupa JSON valid dengan code numerik) |
Nilai code asli dari server |
Teks msg/message asli dari server |
| Gangguan jaringan, atau kode bisnis tidak dapat diurai dari respons | -1 |
Pesan tetap dari SDK |
Proyek ditutup / berganti (HTTP 400 + 40001/40002) |
-4 / -6 |
Lihat tabel di atas |
Lampiran: Kode Bisnis Server yang Umum
Nilai berikut hanya untuk referensi diagnosis dan tidak dijamin tetap sama antarversi SDK atau server:
| Code | Arti |
|---|---|
| 55004 | Parameter bisnis tidak valid, misalnya Bundle Identifier aplikasi belum ditautkan atau tidak cocok dengan sumber data MA, AppKey kanal belum dipetakan di proyek saat ini, atau channelId tidak ada di proyek saat ini; periksa message untuk penyebab spesifik |
| 55108 | EUID tidak valid, misalnya EUID dan MA RID bukan milik pengguna MA yang sama |
| 55110 | Permintaan terlalu sering, misalnya AppPush RID yang sama sedang ditautkan secara bersamaan; dapat dicoba lagi nanti |
| 55000 | Kesalahan sistem server |
Hasil per Pengenal Pengguna
Hasil berikut mencakup validasi lokal SDK dan respons server. Lihat aturan pemrosesan kolom di Kelas MTMAUserID:
| Code | Arti |
|---|---|
| 0 | Pengenal pengguna berhasil diproses |
| 3001 | Nilai pengenal pengguna tidak boleh kosong (kode referensi server; pada versi SDK ini, nilai kosong pada keempat kolom pengenal publik dianggap tidak dikirim dan tidak menghasilkan 3001 per kolom) |
| 3002 | Pengenal pengguna belum didefinisikan di proyek saat ini |
| 3003 | Nilai pengenal pengguna melebihi batas panjang |
| 3013 | Tipe atau format nilai pengenal pengguna tidak valid, termasuk tipe selain NSString |
