Error Code
Ringkasan
Section titled “Ringkasan”Error Code digunakan untuk membantu developer memahami penyebab kegagalan saat menggunakan API TENTA.
Saat request API gagal, sistem biasanya mengembalikan kode error atau pesan error tertentu.
Dengan memahami error code, tim teknis dapat mengetahui apakah masalah terjadi karena autentikasi, data request, batas penggunaan, atau kendala server.
Kapan Digunakan
Section titled “Kapan Digunakan”Error Code digunakan saat request API tidak berhasil diproses.
Gunakan panduan ini untuk:
- Membaca penyebab error API.
- Mengecek kesalahan token atau akses.
- Memperbaiki format data yang dikirim.
- Mengetahui apakah request terkena rate limit.
- Membedakan error dari sisi pengguna dan error dari sisi server.
Error Autentikasi
Section titled “Error Autentikasi”Error autentikasi terjadi ketika sistem tidak dapat memverifikasi akses API.
Penyebab yang sering terjadi:
- API token salah.
- Token sudah tidak aktif.
- Token tidak dikirim di header request.
- Format authentication tidak sesuai.
- Token tidak memiliki izin akses ke endpoint tertentu.
Langkah pengecekan:
- Pastikan API token sudah benar.
- Pastikan token masih aktif.
- Pastikan token dikirim dengan format yang sesuai.
- Cek apakah token memiliki izin untuk endpoint yang digunakan.
Error Validasi
Section titled “Error Validasi”Error validasi terjadi ketika data yang dikirim ke API tidak sesuai dengan format yang dibutuhkan.
Penyebab yang sering terjadi:
- Field wajib belum diisi.
- Format data salah.
- Nomor tujuan tidak valid.
- ID percakapan tidak ditemukan.
- Tipe data tidak sesuai.
- Parameter request kurang lengkap.
Langkah pengecekan:
- Periksa kembali body request.
- Pastikan semua field wajib sudah diisi.
- Cek format data yang dikirim.
- Sesuaikan parameter dengan kebutuhan endpoint.
Error Rate Limit
Section titled “Error Rate Limit”Error rate limit terjadi ketika sistem menerima terlalu banyak request dalam waktu singkat.
Rate limit digunakan untuk menjaga kestabilan sistem dan mencegah penggunaan API secara berlebihan.
Penyebab yang sering terjadi:
- Sistem mengirim request terlalu cepat.
- Ada proses otomatis yang berjalan berulang tanpa jeda.
- Integrasi melakukan pengecekan data terlalu sering.
- Request dikirim dalam jumlah besar tanpa pengaturan antrian.
Langkah pengecekan:
- Kurangi frekuensi request.
- Tambahkan jeda antar request.
- Gunakan sistem antrian jika request cukup banyak.
- Hindari request berulang untuk data yang sama jika tidak diperlukan.
Error Server
Section titled “Error Server”Error server terjadi ketika request sudah dikirim, tetapi sistem tidak dapat memproses karena kendala dari sisi server.
Penyebab yang mungkin terjadi:
- Server sedang sibuk.
- Layanan API sedang mengalami gangguan.
- Terjadi kendala sementara pada sistem.
- Request membutuhkan waktu proses terlalu lama.
Langkah pengecekan:
- Coba ulang request beberapa saat kemudian.
- Pastikan endpoint yang digunakan benar.
- Cek apakah error terjadi berulang atau hanya sesaat.
- Simpan log error untuk bahan pengecekan teknis.
- Hubungi tim support jika error terus terjadi.
Contoh Penggunaan
Section titled “Contoh Penggunaan”Developer mengirim request API untuk mengambil daftar percakapan, tetapi sistem mengembalikan error authentication.
Developer kemudian mengecek token yang digunakan dan menemukan bahwa token belum dimasukkan pada header request.
Setelah token ditambahkan dengan benar, request berhasil diproses.
Catatan Penting
Section titled “Catatan Penting”- Baca pesan error sebelum mengubah integrasi.
- Simpan log request dan response untuk membantu pengecekan.
- Jangan langsung mengulang request terlalu banyak jika terkena rate limit.
- Pastikan token, endpoint, method, dan body request sudah sesuai.
- Jika error server terjadi berulang, hubungi tim support dengan menyertakan detail error.
Kendala yang Sering Terjadi
Section titled “Kendala yang Sering Terjadi”Token Sudah Benar tetapi Tetap Ditolak
Section titled “Token Sudah Benar tetapi Tetap Ditolak”Cek apakah token masih aktif dan memiliki izin untuk endpoint tersebut.
Request Gagal karena Data Tidak Lengkap
Section titled “Request Gagal karena Data Tidak Lengkap”Periksa field wajib dan pastikan semua data sudah dikirim sesuai format.
Terkena Rate Limit Berulang
Section titled “Terkena Rate Limit Berulang”Kurangi frekuensi request dan gunakan jeda antar proses otomatis.
Error Server Tidak Hilang
Section titled “Error Server Tidak Hilang”Simpan detail error, waktu kejadian, endpoint yang digunakan, dan hubungi tim support.
Langkah Selanjutnya
Section titled “Langkah Selanjutnya”Setelah memahami Error Code, lanjutkan ke halaman berikutnya: