Daftar nomor dalam proyek porting

Akses akun dan proyek

Gunakan akun API yang diaktifkan melalui HTTPS dari alamat IP yang diizinkan. Proyek harus dimiliki akun tersebut dan belum dihapus. Gunakan ID unik proyek dari alur pesanan porting, bukan ID numeriknya di basis data atau nomor telepon. Enkodekan ID proyek sebagai URL saat menyusun permintaan.

Permintaan

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"

Respons

Contoh respons fiktif.

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response adalah daftar. Proyek yang ada tetapi tidak memiliki nomor mengembalikan daftar kosong dengan kode API 200 dan status.results bernilai 0. Sebaliknya, proyek yang tidak ada mengembalikan kode API 404.

Kolom nomor

Kolom nomor porting
Kolom	Arti
id, number, isocode	ID baris numerik, teks nomor telepon yang disimpan, dan kode negara. ID baris bukan ID proyek.
status, status_str	Status numerik dan labelnya yang dikenal.
foc	Nilai penjadwalan komitmen pesanan pasti yang disimpan. Nilai ini dapat kosong; handler tidak mengonversinya ke zona waktu atau format stempel waktu yang didokumentasikan.
updated, date_created, date_completed	Nilai pembaruan, pembuatan, dan penyelesaian yang disimpan. Tangani nilai kosong secara eksplisit; jangan menganggapnya sebagai ISO8601 atau menyimpulkan zona waktu dari contoh fiktif.
comment	Komentar tersimpan yang ditujukan kepada pelanggan. Tampilkan sebagai teks, bukan HTML yang dapat dieksekusi.

Struktur respons ini tidak menyertakan kolom khusus staf internal_comment. Ini tidak berarti pencarian lama satu nomor yang terpisah menggunakan struktur respons yang sama.

Urutan dan pemantauan

Kueri mengurutkan berdasarkan waktu pembuatan secara menaik. Baris dengan waktu pembuatan sama tidak memiliki jaminan urutan tambahan. Tidak ada paginasi, kursor inkremental, atau filter tanggal. Baca daftar lengkap untuk merekonsiliasi proyek, dan jangan menganggap jumlah baris saat ini sebagai katalog permanen.

Menafsirkan status porting

Nilai status nomor yang dikenal
Nilai	Label
0	Pending
1	In Progress
2	Completed
9	Rejected

Pertahankan status numerik dan tangani nilai yang tidak dikenal. Label yang tidak dikenal menggunakan nilai tersimpan sebagai cadangan, bukan label baru yang dijamin. Status penyelesaian atau tanggal terjadwal yang disimpan tidak dengan sendirinya menguji perutean masuk atau semua layanan pada nomor tersebut.

Kesalahan dan batasan

Periksa respons HTTP serta status.code/status.msg. Proyek yang tidak ada, dihapus, atau bukan milik akun mengembalikan kode API 404 dengan pesan proyek tidak ditemukan. Pembatasan autentikasi dan IP sumber juga berlaku. Contoh tidak membuat permintaan langsung, dan respons berhasil bukan bukti bahwa operator telah menerima atau menyelesaikan pemindahan.

Dampak

Handler yang ditinjau hanya membaca proyek dan baris nomor yang disimpan. Respons merupakan cuplikan keadaan, bukan konfirmasi operator atau pengujian layanan langsung. Respons tidak memulai porting, mengubah perutean, atau mendebit akun.