Pengembang

GET/v3/countries

Daftar negara dalam katalog (format lama)

Endpoint lama yang mengembalikan negara yang terlihat dan terhubung ke katalog nomor khusus yang digunakan oleh GET /v3/other/{isocode}, dalam badan respons {code, data}. Endpoint ini tidak memeriksa stok. Gunakan GET /v3/getcountries untuk menemukan negara dengan nomor yang tersedia dalam stok.

Di halaman ini
  1. Permintaan
  2. Respons
  3. Kesalahan
  4. Ketersediaan dan efek samping

Endpoint lama ini mengembalikan badan respons {"code", "data"} sebagai pengganti pembungkus standar status/response. Endpoint ini mencantumkan negara yang terlihat dan terhubung ke katalog nomor khusus serta tidak memeriksa stok.

Untuk integrasi baru:

  • Gunakan GET /v3/getcountries untuk menemukan negara dengan nomor yang tersedia dalam stok.
  • Gunakan GET /v3/other/{isocode} untuk melihat jenis nomor khusus yang benar-benar ditawarkan di suatu negara. Negara yang tercantum di sini tetap dapat menghasilkan katalog kosong di sana.

Permintaan

Wajib: HTTP Basic atau token Bearer (lihat Autentikasi dan respons API). Jika autentikasi gagal, HTTP 401 dikembalikan dalam pembungkus standar sebelum pencarian dijalankan.

GET tanpa parameter dan tanpa badan permintaan.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

Respons

Badan respons lama tanpa pembungkus standar: {code: 200, data: [...]}. Tidak ada objek status, maupun kolom msg atau results. data mencantumkan negara tanpa jaminan urutan tertentu. Kolom: countrycode (kode panggilan tanpa '+'), name, description (nilainya sama dengan name), isocode, latitude, dan longitude. Tidak ada kolom is_mobile, sms_coverage, atau next_function. Suatu negara dicantumkan jika terlihat dan terhubung ke katalog nomor khusus. Stok tidak diperiksa, sehingga negara yang tercantum mungkin saat ini tidak memiliki nomor yang tersedia. Jika tidak ada negara yang memenuhi syarat, data bernilai null.

Contoh struktur respons; bukan data akun langsung atau penawaran harga saat ini.

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

Kesalahan

  • 401: Autentikasi tidak disertakan atau gagal. Dikirim dengan HTTP status 401 dalam pembungkus standar status/response, bukan dalam badan respons lama.

Ketersediaan dan efek samping

  • Hanya melakukan pencarian. Tidak mencadangkan, memesan, atau mengubah apa pun.