عرض بلدان الكتالوج (التنسيق القديم)

تعيد نقطة النهاية القديمة هذه متنًا بالصيغة {"code", "data"} بدلًا من الغلاف القياسي status/response. وتسرد البلدان الظاهرة المرتبطة بكتالوج الأرقام الخاصة، ولا تتحقق من المخزون.

لعمليات التكامل الجديدة:

• استخدم GET /v3/getcountries للعثور على البلدان التي تتوفر فيها أرقام في المخزون.
• استخدم GET /v3/other/{isocode} لمعرفة أنواع الأرقام الخاصة المعروضة فعليًا في بلد معين. قد يظهر بلد في هذه القائمة ومع ذلك يُعاد له كتالوج فارغ هناك.

الطلب

المطلوب: مصادقة HTTP Basic أو رمز Bearer (راجع المصادقة واستجابات واجهة API). عند فشل المصادقة، تُعاد استجابة HTTP 401 ضمن الغلاف القياسي قبل تنفيذ البحث.

GET دون معلمات ودون متن.

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

الاستجابة

متن بالتنسيق القديم دون الغلاف القياسي: {code: 200, data: [...]}. لا يوجد كائن status ولا حقل msg أو results. يسرد data البلدان دون ترتيب مضمون. الحقول: countrycode (رمز الاتصال دون '+')، وname، وdescription (بالقيمة نفسها التي يحملها name)، وisocode، وlatitude، وlongitude. لا توجد حقول is_mobile أو sms_coverage أو next_function. يُدرج البلد عندما يكون ظاهرًا ومرتبطًا بكتالوج الأرقام الخاصة. لا يُتحقق من المخزون، لذا قد لا تتوفر حاليًا أي أرقام لبلد مدرج. إذا لم يستوفِ أي بلد الشروط، تكون قيمة data هي null.

بنية استجابة توضيحية؛ وليست بيانات حساب حية أو عرض سعر حاليًا.

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

الأخطاء

• 401: المصادقة مفقودة أو فشلت. تُرسل الاستجابة مع HTTP status 401 ضمن الغلاف القياسي status/response، وليس ضمن المتن بالتنسيق القديم.

التوفر والآثار الجانبية

• للاستعلام فقط. لا تحجز نقطة النهاية هذه أي شيء، ولا تقدم أي طلب شراء، ولا تغيّر أي شيء.