Baca satu nomor yang telah dibeli

Baca satu rekaman nomor yang telah dibeli beserta konfigurasi tersimpannya. Operasi ini mengembalikan objek, bukan larik seperti yang dikembalikan oleh endpoint inventory.

Permintaan

Gunakan kredensial API di sisi server melalui HTTPS. Contoh-contoh ini membaca kredensial dari variabel lingkungan; tidak ada kredensial yang dapat digunakan di dalamnya. Periksa status.code dalam isi JSON serta status HTTP. Penangan lama ini tidak selalu menetapkan status kesalahan HTTP ketika terjadi kesalahan aplikasi.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

Segmen jalur yang wajib disertakan adalah nomor telepon internasional yang tersimpan, bukan UUID nomor tersebut atau ekstensi PBX. Penangan ini tidak menggunakan parameter kueri maupun isi permintaan.

Respons

Ini adalah ilustrasi struktur respons, bukan data akun atau penawaran harga terkini.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

Kolom nomor yang dikembalikan
Kolom	Arti
`number, uuid, description, isocode`	Nomor telepon yang tersimpan, pengenal nomor yang harus diperlakukan sebagai nilai tanpa makna yang dapat ditafsirkan, deskripsi, dan kode negara.
`config`	Kolom tersimpan untuk tujuan panggilan suara, penerusan eksternal, tujuan SMS, dan penerusan SMS. Endpoint ini tidak mengubahnya.
`features`	Penanda kemampuan panggilan suara, SMS, dan MMS yang tersimpan. Penanda lama yang tersimpan tidak dijamin berupa nilai boolean JSON.
`status.capacity`	Nilai kanal yang dialokasikan dan digunakan, pengaturan luapan, serta biaya kelebihan pemakaian yang tersimpan. Ini adalah metadata tersimpan, bukan penawaran kapasitas terbaru atau pengujian panggilan langsung.
`status.origination`	Metadata asal panggilan yang tersimpan. Perlakukan pengenal sebagai nilai tanpa makna yang dapat ditafsirkan; jangan mendasarkan logika aplikasi pada nama internal.
`status.service_active, force_codec, force_dtmf`	Kolom aktivasi dan konfigurasi media yang tersimpan. Penanda saja tidak membuktikan bahwa pengiriman masuk berhasil.
`billing`	Nilai CNAM, luapan, perpanjangan, persistensi, dan pembuatan yang tersimpan. Membacanya tidak mengubah pengaturan perpanjangan atau pengaturan penagihan lainnya.
`price`	Harga penyiapan/bulanan/per menit dan kuota menit yang tersimpan. Penangan ini tidak menyediakan kolom mata uang maupun penawaran harga terbaru. Jangan menyimpulkan mata uang dari nilai contoh atau menggunakannya sebagai penawaran harga pembelian terkini.

Dibandingkan dengan inventory, endpoint ini juga mengembalikan needs_registration, vrating, country_id, area_id, provider_id dan price.perminute_charges. Semua ini adalah nilai lama yang tersimpan, bukan respons persetujuan identitas yang terpisah. ID referensi harus diperlakukan sebagai nilai tanpa makna yang dapat ditafsirkan; jangan menyusun URL penemuan atau menyimpulkan pemetaan penyedia dari ID tersebut tanpa respons penemuan yang sesuai.

Tidak ada nomor yang cocok

Jika tidak ditemukan rekaman yang cocok dan tidak dibatalkan untuk akun yang telah diautentikasi, isi JSON memuat status.code 404 dan pesan yang memuat number not found. Jangan mengandalkan akhiran pesan yang menunjukkan baris kode sumber. Periksa nomor yang tersimpan dan inventory sebelum mencoba lagi.

Gunakan hasilnya

Operasi ini membaca data yang telah disimpan. Operasi ini tidak membeli nomor, menyetujui dokumen identitas, mengubah tujuan, atau menjamin bahwa panggilan, faks, atau pesan akan terkirim. Uji setiap layanan yang diaktifkan secara terpisah saat mengonfigurasi nomor.