تقييم رقم الجوال

تتحقق من رقم هاتف لدولة محددة وتخبرك بمشغّله وهل يبدو حقيقيًا أم مؤقتًا.

نظرة عامة#

تحتاج scoring/phone مدخلين: الرقم phone ودولته countryCode (بصيغة ISO 3166-1 alpha-2 مثل US). يمكن كتابة الرقم بعدة طرق، مع علامة الزائد أو بدونها ومع البادئة الوطنية أو بدونها. تحوي الاستجابة phone بعد التطبيع وisValid وreason عند عدم الصلاحية وcarrier ومؤشر disposable للأرقام المؤقتة أو الافتراضية وblacklisted.

متى تستخدمه#

• للتحقق من الأرقام عند التسجيل قبل إرسال رمز SMS، فتوفّر تكلفة رسائل إلى أرقام لا تستقبلها.
• لتصفية الأرقام المؤقتة والافتراضية المستخدمة في إساءة العروض.
• لتوحيد صيغة الأرقام قبل تخزينها.

قراءة النتيجة#

• isValid: false مع reason مثل بنية غير صالحة يعني أن الرقم لا يمكن أن يتبع تلك الدولة. اطلب من المستخدم تصحيحه ولا ترسل رمزًا.
• disposable: true تدل على رقم مؤقت. اقبله حيث تكون المخاطرة منخفضة فقط، أو اطلب عامل تحقق أقوى.
• قد يكون carrier فارغًا خاصة للأرقام غير الصالحة، وقد يتغير المشغّل عند نقل الأرقام، فاعتبره معلومة إرشادية لا مرجعًا حاسمًا.
• مرّر دائمًا الدولة التي اختارها المستخدم لا التي خُمّنت من IP، وإلا قد تُعدّ أرقام صحيحة غير صالحة.

ملاحظات#

• تُحتسب طلبًا واحدًا. وضع الاختبار يُرجع بيانات وهمية مجانًا دون أحداث.
• ليست ضمن الباقة القياسية؛ متاحة في التجربة والمميّزة والدفع حسب الاستخدام. وبدون صلاحية يصلك الخطأ 117 (feature_not_available).
• يمكن لـالقواعد المخصصة في مجموعة الجوال اختبار الرقم والدولة والمشغّل وتعليم الرقم كصالح أو غير صالح. وتُسرد النتيجة في custom_rules_applied.
• يُطلَق حدث spam_phone للأرقام المعتبرة وهمية أو مسيئة ويُرسل إلى الويب هوك.
• الرقم المفقود أو غير القابل للتحليل يُرجع الخطأ 118 (invalid_phone_number) والدولة الخاطئة تُرجع 116 (invalid_country_code)، كلاهما مع HTTP 200.

الطلب#

• صادِق بمعامل key أو بترويسة Authorization: Bearer.
• تُحتسب طلباً واحداً.
• متاحة في: تجربة مجانية المميّزة الدفع حسب الاستخدام

المعاملات#

تقبل كل خدمة أيضاً format, lang, mode, userID, callback. راجع الخيارات.

أمثلة برمجية#

curl -G "https://gurdx.cretip.com/api/scoring/phone" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "phone=501234567" \
  --data-urlencode "countryCode=SA"

<?php

$response = file_get_contents('https://gurdx.cretip.com/api/scoring/phone?'.http_build_query(['key' => 'YOUR_API_KEY', 'phone' => '501234567', 'countryCode' => 'SA']));
$result = json_decode($response, true);

if ($result['status'] === 'success') {
    print_r($result['data']);
} else {
    echo $result['code'].': '.$result['description'];
}

const params = new URLSearchParams({"key":"YOUR_API_KEY","phone":"501234567","countryCode":"SA"});
const res = await fetch(`https://gurdx.cretip.com/api/scoring/phone?${params}`);
const result = await res.json();

if (result.status === 'success') {
  console.log(result.data);
} else {
  console.error(result.code, result.description);
}

import requests

res = requests.get("https://gurdx.cretip.com/api/scoring/phone", params={"key": "YOUR_API_KEY", "phone": "501234567", "countryCode": "SA"})
result = res.json()

if result["status"] == "success":
    print(result["data"])
else:
    print(result["code"], result["description"])

الاستجابة#

نجاح#

{
    "data": {
        "carrier": "",
        "reason": "Invalid phone number structure.",
        "isValid": false,
        "blacklisted": false,
        "disposable": false,
        "phone": "+12121234567",
        "countryCode": "US",
        "custom_rules_applied": {
            "total": 0,
            "rules": []
        }
    },
    "status": "success",
    "executionTime": 1
}

خطأ#

تُسلَّم الأخطاء بحالة HTTP 200 — افحص دائماً حقل status.

{
    "status": "error",
    "code": 101,
    "type": "invalid_key",
    "description": "The API Key is missing or invalid."
}

حقول الاستجابة#