قراءة خطة سعر محفوظة
ابحث عن صفوف الأسعار المحفوظة لحساب API الخاص بك بعد تصفّح أرقام الهاتف المتاحة. استخدم قيمة uuid الخاصة بخيار السعر من قائمة price الخاصة بالرقم المحدد، وليس رقمه أو معرّف البادئة أو معرّف المنطقة. احتفظ بالرقم المحدد وخيار السعر معًا.
هذا بحث توافقي في الأسعار المحفوظة. فهو لا يحدّث التوفر أو الأسعار، ولا يحجز رقمًا، ولا يرسل طلب شراء، ولا يضمن مبلغ عملية شراء مستقبلية. راجع خيار السعر المُعاد مع بحث جديد عن الأرقام قبل الشراء.
الطلب
استخدم حساب API المفعّل الخاص بك عبر HTTPS من عنوان IP مسموح به. اضبط PRICE_ID على معرّف خيار السعر الدقيق الذي تلقيته. تقرأ الطريقة وسيطة مسار واحدة ولا تقرأ أي معلمات للنص الأساسي أو التاريخ أو ترقيم الصفحات.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"يجب أن يُجري هذا البحث الحساب نفسه الذي حصل على خيار السعر. لا تُنشئ معرّفًا بنفسك، ولا تستخدم رقم صف من قاعدة البيانات، ولا تستبدل اختيار حساب آخر. لا تطابق الطريقة القديمة سوى معرّف السعر المرئي.
الاستجابة
يعرض المثال الخيالي التالي حقولًا مختارة موجهة للعميل فقط. أما الاستجابات الفعلية فتُعيد صفوفًا محفوظة كاملة وقد تتضمن بيانات وصفية إضافية عن الحساب والمورّد والتسعير الداخلي. احتفظ بالاستجابة الكاملة على خادمك واعرض فقط القيم الموجهة للعميل التي يحتاجها تطبيقك.
{
"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 هو قائمة، حتى عند وجود صف واحد. status.results يُحصي الصفوف المُعادة. يمكن أن تكون القيم الرقمية من قاعدة البيانات سلاسل نصية. لا تضيف نقطة النهاية حقل عملة ولا تحوّل العملات؛ تأكد من عملة الفوترة الخاصة بالحساب بدلًا من استنتاجها من هذا المثال.
حقول السعر
| الحقل | المعنى |
|---|---|
| visible_uuid | المعرّف المرئي لخيار السعر المحفوظ. استخدم معرّف الخيار الأصلي عند ربط نتيجة البحث. |
| setup_price | سعر الإعداد لمرة واحدة المخزّن لهذا الخيار. |
| monthly_price | السعر الشهري المتكرر المخزّن. |
| per_minute, free_minutes | سعر الدقيقة المخزّن للمكالمات الواردة وكمية الدقائق المضمّنة المخزّنة. لا يحدد هذان الحقلان أسعار المكالمات الصادرة ولا كل رسم إضافي محتمل. |
| channels | عدد القنوات المخزّن لهذا الخيار؛ وهو ليس فحصًا مباشرًا للسعة أو التسجيل. |
| yearly_price | قد يكون هناك حقل إضافي مخزّن للسعر السنوي. لا تستنتج أن وجود سعر شهري غير صفري مع حقل سنوي صفري يمثل خطة سنوية مجانية. |
التعامل مع الصفوف المتطابقة المتعددة
يمكن أن يُعيد البحث أكثر من صف محفوظ واحد. لا توفر الطريقة ترتيبًا مضمونًا ولا اختيارًا لأحدث صف ولا تصفية حسب الرقم أو البادئة. لا تختر الصف الأول أو الأخير بصمت. قارن السياق المُعاد بالرقم المحدد الأصلي وخيار السعر؛ وإذا ظل غامضًا أو قديمًا، فأعد البحث عن الأرقام بدلًا من التعامل مع هذه الاستجابة كعرض سعر لطلب الشراء.
ينفّذ سير عمل مراجعة طلبات الشراء في البوابة عمليات اختيار وتحقق من الصلاحية إضافية. لا تفترض أن هذا البحث القديم ينفّذ تلك الفحوصات أو يقبل كل معرّف تقبله البوابة.
الاستجابات الفارغة والأخطاء
إذا لم يتطابق أي صف محفوظ، فلا يُصدر المعالج الحالي أي نتيجة JSON ولا أي استجابة صريحة بعدم العثور. النص الأساسي الفارغ ليس سعرًا صفريًا ولا خطة متاحة ولا بحثًا ناجحًا مؤكدًا. تحقق من استجابة HTTP وبنية JSON معًا؛ ولا تُجرِ عملية شراء استنادًا إلى بيانات سعر مفقودة أو غير قابلة للتحليل.
يمكن أيضًا أن تمنع المصادقة وقيود عنوان IP المصدر وأعطال قاعدة البيانات الحصول على استجابة قابلة للاستخدام. لا يوجد غلاف خطأ خاص بالمعالج لاستثناء قاعدة البيانات. أعد تحديد اختيارك أو تواصل مع الدعم عندما يظل البحث الموثَّق غير متاح.
الآثار والحدود
ينفّذ البحث الذي تمت مراجعته استعلام قراءة ولا يتضمن أي خصم أو شراء أو حجز أو تحديث لأسعار المزوّد. لا تثبت قراءة الأسعار المحفوظة المخزون الحالي ولا الموافقة التنظيمية ولا إذن الشراء للحساب ولا الفوترة النهائية.