Ambil catatan panggilan akun
Baca catatan panggilan masuk atau keluar untuk akun API Anda. Catatan ini berisi informasi panggilan dan penagihan yang bersifat pribadi. Simpan catatan tersebut dalam alur kerja sisi server yang berwenang dan hindari pencatatan log atau pembagian yang tidak diperlukan.
Endpoint lama ini saat ini memiliki rentang tanggal bawaan yang tetap dan tidak menyediakan paginasi. Gunakan alur kerja riwayat panggilan atau ekspor di portal jika Anda memerlukan periode pelaporan lain atau ekspor data historis dalam jumlah besar; parameter tanggal khusus pada endpoint ini tidak dapat diandalkan.
Permintaan
Lakukan autentikasi melalui HTTPS menggunakan akun API Anda yang telah diaktifkan, dari alamat IP sumber yang diizinkan untuk akun tersebut. Contoh ini menggunakan kredensial dalam variabel lingkungan. Permintaan untuk rentang waktu bawaan yang didukung tidak memerlukan isi permintaan.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Jalur | Cakupan |
|---|---|
| /v3/cdrs | Catatan panggilan masuk akun dalam rentang tanggal bawaan. |
| /v3/cdrs/{number} | Catatan panggilan masuk yang nomornya sama persis dengan nomor yang diberikan. Sebaiknya gunakan seluruh digit nomor sebagaimana tercantum dalam inventaris Anda. |
| /v3/cdrs/all/outbound | Catatan panggilan keluar akun dalam rentang tanggal bawaan. Cabang pemrosesan panggilan keluar mengabaikan argumen jalur pertama; all di sini merupakan penanda tempat, bukan karakter pengganti untuk panggilan masuk. |
Gunakan nilai arah inbound atau outbound persis seperti yang ditampilkan di atas. Cabang pemrosesan panggilan keluar tidak menerapkan filter per nomor. Menambahkan nomor ke jalur tersebut tidak mempersempit hasil panggilan keluar.
Rentang waktu pelaporan bawaan
Kueri dimulai pada tengah malam di tanggal kalender server 30 hari sebelum hari ini dan berakhir pada tengah malam di awal hari ini. Karena itu, sisa waktu pada hari ini tidak tercakup. Ini bukan rentang waktu bergulir selama 720 jam yang berakhir pada waktu saat ini.
Implementasi saat ini tidak mendukung kolom formulir date_from/date_to secara andal: pemberian tanggal khusus membuat variabel tahun partisinya tidak terisi. Jangan gunakan kolom tersebut untuk laporan produksi. Tanggal pada string kueri dan parameter paginasi juga tidak diterapkan sebagai alternatif.
Respons
Hanya beberapa kolom panggilan masuk yang dipilih sebagai ilustrasi; data ini fiktif dan bukan catatan lengkap yang dikembalikan.
{
"status": {
"code": "200",
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550123",
"callerid": "12025550124",
"disposition": "ANSWERED",
"billseconds": "60",
"billcost": "0.0100",
"callsid": "11111111111111111111111111111111",
"date_created": "2026-10-01 12:00:00 UTC"
}
]
}response berupa daftar. Struktur pembungkus respons bersama dapat menyertakan status.results sebagai jumlah barisnya. Kode hasil dapat berupa string. Jika tidak ada catatan, hasilnya menggunakan kode API 404 dengan pesan No entries found, alih-alih daftar kosong yang menandakan keberhasilan.
Kolom catatan
| Kolom | Arti |
|---|---|
| number, callerid | Nomor panggilan masuk dan pengenal pemanggil dalam kolom hasil yang dipilih untuk panggilan masuk. |
| calling, called, callerid | Pengenal pihak pemanggil dan pihak yang dipanggil dalam kolom hasil yang dipilih untuk panggilan keluar. Jangan menyimpulkan bahwa identitas pelanggan telah terverifikasi berdasarkan ID pemanggil. |
| disposition, billseconds, billcost | Status hasil panggilan yang tersimpan, durasi yang ditagihkan, dan jumlah tagihan yang tersimpan. Nilainya dapat menggunakan format string basis data lama. |
| callsid | UUID panggilan yang tersimpan untuk menghubungkan data terkait. |
| date_created | String tanggal dan waktu dengan akhiran literal UTC, bukan stempel waktu yang dijamin berformat ISO8601. Uraikan format yang dikembalikan dengan menentukan formatnya secara eksplisit. |
| Kolom lainnya | Catatan panggilan masuk juga mencakup informasi diagnostik kegagalan, biaya, kanal, kualitas, dan asal; catatan panggilan keluar mencakup informasi diagnostik wilayah terminasi panggilan. Respons lengkap dapat memuat informasi infrastruktur dan harus diperlakukan sebagai informasi pribadi. |
Endpoint ini tidak menambahkan pengurutan eksplisit maupun paginasi. Jangan menganggap hasil diurutkan dari yang terbaru, urutan baris tetap stabil, atau tersedia kursor sinkronisasi inkremental. Kolom penagihan yang dikembalikan merupakan bagian dari catatan panggilan yang tersimpan, bukan penawaran harga untuk panggilan mendatang.
Kesalahan dan batasan pelaporan
Baca status HTTP serta status.code/status.msg dalam JSON. Jika tidak ada entri pada akun dan rentang waktu yang dipilih, kode API 404 dikembalikan. Autentikasi dan pembatasan IP sumber juga berlaku. Laporan besar tanpa paginasi atau permintaan tanggal khusus yang tidak andal dapat gagal; pemeriksaan berulang terhadap seluruh tabel bukan strategi ekspor inkremental.
Penangan yang ditinjau berisi kueri baca dan tidak melakukan pendebitan akun maupun memulai panggilan. Catatan yang dikembalikan tidak membuktikan bahwa seseorang menjawab; tafsirkan status hasil panggilan dan durasi yang tersimpan sesuai kebutuhan pelaporan Anda.