Membaca paket harga tersimpan
Cari baris harga yang tersimpan untuk akun API Anda setelah menelusuri nomor telepon yang tersedia. Gunakan uuid milik opsi harga dari daftar price pada nomor yang dipilih, bukan nomor itu sendiri, ID prefiks, atau ID areanya. Jaga agar nomor yang dipilih dan opsi harga tetap bersama.
Ini adalah pencarian kompatibilitas atas harga tersimpan. Pencarian ini tidak menyegarkan ketersediaan atau harga, tidak mencadangkan nomor, tidak melakukan pemesanan, dan tidak menjamin jumlah pembelian di masa mendatang. Tinjau opsi harga yang dikembalikan oleh pencarian nomor yang baru sebelum memesan.
Permintaan
Gunakan akun API Anda yang telah diaktifkan melalui HTTPS dari alamat IP yang diizinkan. Setel PRICE_ID ke ID opsi harga persis seperti yang Anda terima. Metode ini membaca satu argumen path dan tidak membaca parameter body, tanggal, atau paginasi.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"Akun yang sama yang memperoleh opsi harga harus melakukan pencarian ini. Jangan menyusun ID sendiri, menggunakan nomor baris basis data, atau menggantinya dengan pilihan akun lain. Metode lama ini hanya mencocokkan ID harga yang terlihat.
Respons
Contoh fiktif berikut hanya menampilkan sebagian field yang ditujukan untuk pelanggan. Respons sebenarnya mengembalikan baris tersimpan secara lengkap dan dapat menyertakan metadata tambahan tentang akun, pemasok, dan harga internal. Simpan respons lengkap di server Anda dan tampilkan hanya nilai untuk pelanggan yang dibutuhkan aplikasi Anda.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response adalah sebuah daftar, bahkan untuk satu baris. status.results menghitung baris yang dikembalikan. Nilai numerik dari basis data dapat berupa string. Endpoint ini tidak menambahkan field mata uang maupun mengonversi mata uang; konfirmasikan mata uang penagihan akun alih-alih menyimpulkannya dari contoh ini.
Field harga
| Field | Arti |
|---|---|
| visible_uuid | Pengenal yang terlihat dari opsi harga tersimpan. Gunakan ID opsi asli saat mengorelasikan pencarian. |
| setup_price | Harga penyiapan satu kali yang tersimpan untuk opsi ini. |
| monthly_price | Harga bulanan berulang yang tersimpan. |
| per_minute, free_minutes | Tarif per menit panggilan masuk dan jumlah menit yang disertakan, sebagaimana tersimpan. Nilai ini tidak menyatakan tarif panggilan keluar atau setiap kemungkinan biaya tambahan. |
| channels | Jumlah kanal yang tersimpan untuk opsi ini; ini bukan pemeriksaan kapasitas langsung atau pemeriksaan registrasi. |
| yearly_price | Field harga tahunan tersimpan tambahan mungkin ada. Jangan menyimpulkan bahwa harga bulanan yang bukan nol dan field tahunan yang bernilai nol berarti paket tahunan gratis. |
Menangani beberapa baris yang cocok
Sebuah pencarian dapat mengembalikan lebih dari satu baris tersimpan. Metode ini tidak menyediakan pengurutan yang terjamin, pemilihan baris terbaru, atau filter nomor/prefiks. Jangan diam-diam memilih baris pertama atau terakhir. Bandingkan konteks yang dikembalikan dengan nomor yang dipilih dan opsi harga semula; jika masih ambigu atau usang, segarkan pencarian nomor alih-alih memperlakukan respons ini sebagai penawaran harga pesanan.
Alur kerja peninjauan pesanan di portal melakukan pemeriksaan pemilihan dan keabsahan tambahan. Jangan berasumsi bahwa pencarian lama ini menerapkan pemeriksaan tersebut atau menerima setiap pengenal yang diterima oleh portal.
Respons kosong dan kesalahan
Jika tidak ada baris tersimpan yang cocok, handler saat ini tidak mengeluarkan hasil JSON maupun respons tidak-ditemukan yang eksplisit. Body kosong bukan berarti harga nol, paket yang tersedia, atau pencarian berhasil yang terkonfirmasi. Periksa baik respons HTTP maupun struktur JSON; jangan memesan berdasarkan data harga yang hilang atau tidak dapat diurai.
Autentikasi, pembatasan IP sumber, dan kegagalan basis data juga dapat menghalangi respons yang dapat digunakan. Tidak ada amplop kesalahan khusus handler untuk pengecualian basis data. Segarkan pilihan Anda atau hubungi dukungan jika pencarian terautentikasi tetap tidak tersedia.
Efek dan batasan
Pencarian yang ditinjau ini menjalankan kueri baca dan tidak mengandung pendebitan, pembelian, pencadangan, atau penyegaran harga penyedia. Membaca harga tersimpan tidak menetapkan inventaris saat ini, persetujuan regulasi, izin pembelian akun, atau penagihan final.