Membaca proyek pemindahan nomor

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 pemesanan pemindahan 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"

Perlakukan respons ini sebagai informasi rahasia

Respons lengkap mencakup informasi penagihan operator asal, termasuk nilai tersimpan untuk billing_pin, akun penagihan, telepon, alamat, perusahaan, dan rincian kontak yang berwenang. API tidak menyamarkan kolom-kolom ini. Minta hanya status atau daftar nomor jika hanya itu yang dibutuhkan alur kerja Anda. Jangan simpan respons detail lengkap di penyimpanan peramban, sistem analitik, log publik, atau tangkapan layar untuk dukungan, dan tampilkan hanya kolom yang dibutuhkan pelanggan yang berwenang.

Struktur respons

Contoh fiktif dengan kolom pilihan; respons dapat mengembalikan kolom tambahan.

{
  "status": {
    "code": 200,
    "msg": "Project Detail"
  },
  "response": {
    "project": {
      "id": 11,
      "uniqueid": "PROJECT_EXAMPLE",
      "project_name": "Example transfer",
      "location": "US",
      "status": 0,
      "status_str": "Pending"
    },
    "counts": {
      "total": 0,
      "pending": 0,
      "in_progress": 0,
      "completed": 0,
      "rejected": 0
    },
    "numbers": [],
    "events": [],
    "uploads": []
  }
}

Contoh yang sengaja dibuat tidak lengkap ini tidak menyertakan seluruh kredensial penagihan dan nilai kontak pribadi. Tidak dicantumkannya data tersebut dalam contoh bukan berarti respons sebenarnya menyembunyikannya.

Bagian detail proyek
Bagian	Isi
project	ID baris numerik, ID unik proyek, nama proyek, lokasi, data penagihan/kontak/alamat yang tersimpan, waktu pembuatan, dan status hasil perhitungan. Nama kolom lama untuk operator asal dieja loosing_carrier.
counts	Jumlah total baris nomor serta hitungan untuk Pending, In Progress, Completed, dan Rejected.
numbers	Proyeksi data nomor yang sama dengan titik akhir daftar nomor proyek, termasuk komentar pelanggan dan nilai penjadwalan yang tersimpan.
events	Baris peristiwa yang tersimpan serta kolom muatan mentah/hasil penguraian, dengan mengikuti batas visibilitas dan format pada titik akhir peristiwa.
uploads	Metadata dokumen: ID numerik, upload_type, file_name, file_extension, date_created, dan download_url relatif. URL tersebut tetap memerlukan autentikasi akun.

Memahami ringkasan dan metadata

Status hasil perhitungan memprioritaskan In Progress, lalu Pending, lalu Completed, lalu Rejected, dengan Pending sebagai nilai cadangan. Ringkasan Completed dapat muncul meskipun ada nomor yang ditolak. Periksa hitungan dan status setiap nomor alih-alih menganggap pemindahan semua nomor telah selesai.

Respons berisi metadata dokumen, bukan bita berkas. Tidak ada paginasi atau kursor inkremental. Kueri detail dan daftar merupakan pembacaan terpisah, bukan satu rekaman keadaan yang dijamin konsisten secara transaksional. Tanggal tetap berupa nilai yang tersimpan, tanpa konversi zona waktu yang terdokumentasi. Gunakan uniqueid untuk rute proyek; ID numerik proyek tidak dapat digunakan sebagai penggantinya.

Kesalahan dan batasan

Periksa keduanya: respons HTTP dan status.code/status.msg. Proyek yang tidak ada, telah dihapus, atau bukan milik akun 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 dan alur kerja

Ini adalah rute detail kanonis yang digunakan oleh tampilan pesanan pemindahan nomor pada portal saat ini. Portal memetakan kolom untuk antarmuka penggunanya dan menerapkan proyeksi datanya sendiri untuk pelanggan; jangan menganggap respons mentah API identik dengan JSON atau penyajian portal. Penangan detail yang telah ditinjau tidak mengubah proyek ataupun secara langsung memulai permintaan ke operator atau pembebanan biaya.