Akses akun dan proyek
Gunakan akun API yang aktif melalui HTTPS dari alamat IP yang diizinkan. Proyek harus dimiliki oleh akun tersebut dan tidak boleh sudah dihapus. Gunakan ID unik proyek dari alur kerja pesanan portabilitas nomor, bukan ID numeriknya di basis data atau nomor telepon. Terapkan pengodean URL pada ID proyek saat menyusun permintaan.
Permintaan
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/events"Respons
Contoh respons fiktif.
{
"status": {
"code": 200,
"msg": "Project Events",
"results": 1
},
"response": [
{
"id": 31,
"subject": "Example project update",
"event": "{\"type\":\"comment\",\"value\":\"Example update\",\"source\":\"Example source\"}",
"type": "comment",
"value": "Example update",
"source": "Example source",
"date_created": "2026-10-23 12:00:00"
}
]
}Proyek yang ada tanpa peristiwa mengembalikan kode API 200, daftar kosong, dan status.results bernilai 0. Hasil diminta dengan urutan waktu pembuatan dari terbaru ke terlama, tanpa pengurutan tambahan untuk waktu yang sama, paginasi, kursor, atau filter tanggal.
Baca muatan peristiwa dengan cermat
id adalah ID numerik baris peristiwa, subject adalah subjeknya yang tersimpan, dan date_created adalah nilai tanggal/waktunya yang tersimpan. Endpoint mempertahankan string mentah event dan juga mencoba mendekode propertinya, yaitu type, value dan source. Jika muatan bukan objek JSON atau suatu properti tidak ada, kolom hasil penguraian yang bersangkutan berupa string kosong.
Muatan bukan enumerasi tetap dan tidak dijamin mengikuti skema teks biasa. Jangan perlakukan teks sumber sebagai identitas yang telah diverifikasi atau merender isi peristiwa sebagai HTML. Simpan peristiwa mentah dalam alur kerja sisi server yang berwenang dan tampilkan hanya teks yang sesuai kepada pengguna yang berwenang. Endpoint ini tidak memiliki filter visibilitas peristiwa terpisah untuk staf/pelanggan maupun penyamaran konten.
Riwayat bukan jaminan penyampaian
Ini adalah riwayat proyek yang tersimpan, bukan aliran webhook, kursor sinkronisasi yang tidak dapat diubah, atau catatan lengkap setiap perubahan basis data. Misalnya, penambahan nomor melalui penangan penambahan nomor yang telah ditinjau tidak dengan sendirinya membuat peristiwa. Selain membaca peristiwa, cocokkan juga daftar nomor dan jumlah berdasarkan status.
Kesalahan dan batasan
Periksa respons HTTP serta status.code/status.msg. Proyek yang tidak ada, sudah dihapus, atau bukan milik akun tersebut mengembalikan kode API 404 dengan pesan bahwa proyek tidak ditemukan. Autentikasi dan pembatasan IP sumber juga berlaku. Contoh-contoh ini tidak mengirim permintaan langsung, dan respons yang berhasil bukan bukti bahwa operator telah menerima atau menyelesaikan pemindahan.
Dampak
Penangan yang telah ditinjau membaca peristiwa yang tersimpan dan tidak mengubah proyek, memulai pemindahan, atau mendebit akun. Visibilitas penulis peristiwa dan pengujian akun terautentikasi masih menjadi bagian dari peninjauan kontrak antarmuka yang tertunda.