التحقق من رقم هاتف
معلومة مهمة. التحقق من الصيغة وبادئات Google محلياً. لا تكشف هوية المشترك أو نشاط الخط أو المشغّل الحالي أو الموقع الفعلي.
فهم الإجابة
data: النتائج المطلوبة، في كائن أو قائمة.
meta: مصادر البيانات ورخصتها وتواريخها. تعني null أن القيمة غير معروفة أو غير متاحة.
API v2 هو المسار المرجعي. تبقى مسارات /api/v1 القديمة أسماء بديلة متوافقة مع السلوك المنشور حالياً، بما فيه تقسيم الصفحات؛ لم يُحدد موعد لحذفها.
حقول الإجابة 9
تشير [] إلى كل عنصر في القائمة. تعني null غير معروف أو غير متاح، ولا تعني صفراً. لغة الدليل لا تترجم قيم المصادر.
dataobjectالنتيجة المطلوبة: كائن واحد أو قائمة.
data.is_possiblebooleanطول الرقم متوافق مع مخطط الترقيم؛ لا يثبت وجود الرقم.
data.is_valid_formatbooleanالصيغة مطابقة لبيانات المحلل؛ لا تثبت تخصيص الرقم أو إمكانية الاتصال به.
data.is_allocated_rangenullغير معروف هنا: بيانات البادئات ليست سجلاً رسمياً لتخصيص الأرقام.
القيم المقبولة:
nulldata.has_known_prefixbooleanتوجد بادئة مطابقة في البيانات، بصرف النظر عن صلاحية الرقم.
data.e164string | nullالرقم الدولي الموحد مع +212، رمز الاتصال بالمغرب.
data.national_numberstring | nullالرقم بالصيغة الوطنية المغربية مع الصفر الأول.
data.number_typestring | nullالنوع الذي يتعرف عليه المحلل، مثل الهاتف المحمول أو الثابت.
data.reasonstring | nullرمز يوضح سبب رفض الرقم؛ null عند عدم وجود سبب للرفض.
بنية البيانات
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"is_possible",
"is_valid_format",
"is_allocated_range",
"has_known_prefix",
"e164",
"national_number",
"number_type",
"reason"
],
"properties": {
"is_possible": {
"type": "boolean",
"description": "Length compatibility with the numbering plan."
},
"is_valid_format": {
"type": "boolean",
"description": "Validity against the pinned parser metadata; does not prove line assignment or reachability."
},
"is_allocated_range": {
"type": "string",
"description": "Unknown: the prefix mapping dataset is not an official allocation registry.",
"nullable": true,
"enum": [
null
]
},
"has_known_prefix": {
"type": "boolean",
"description": "A prefix mapping exists, independently of format validity."
},
"e164": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"national_number": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"number_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"reason": {
"anyOf": [
{
"enum": [
"INVALID_CHARACTERS",
"INVALID_LENGTH",
"NOT_MOROCCAN",
"INVALID_NUMBER_PATTERN"
]
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"total",
"license",
"retrieved_at",
"transformation_version",
"sources"
],
"properties": {
"dataset": {
"enum": [
"phone-numbers"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"license": {
"enum": [
"Apache-2.0"
]
},
"retrieved_at": {
"type": "string",
"format": "date"
},
"transformation_version": {
"type": "string"
},
"sources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"producer",
"source_url",
"resource_url",
"license",
"source_updated_at"
],
"properties": {
"dataset": {
"type": "string"
},
"producer": {
"type": "string"
},
"source_url": {
"type": "string",
"format": "uri"
},
"resource_url": {
"type": "string",
"format": "uri"
},
"license": {
"enum": [
"Apache-2.0"
]
},
"source_updated_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
}
}
}
}
}
}
}
}المصادر وتقسيم الصفحات 13
metaobjectسياق النتيجة: المصادر والتواريخ والرخصة وتقسيم الصفحات عند الاقتضاء.
meta.datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
القيم المقبولة:
"phone-numbers"meta.totalintegerعدد النتائج المطابقة للمرشحات قبل تقسيم الصفحات؛ وليس حجم هذه الصفحة.
meta.licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"Apache-2.0"meta.retrieved_atstringتاريخ جلب المشروع لملف المصدر؛ وليس تاريخ رصد البيانات.
meta.transformation_versionstringإصدار قواعد تحويل مجموعة البيانات؛ مستقل عن إصدار الواجهة.
meta.sourcesobject[]المصادر المستخدمة لهذه النتيجة مع الجهات المنتجة والرخص.
meta.sources[].datasetstringاسم مجموعة البيانات الخاصة بالنتيجة أو المصدر.
meta.sources[].producerstringالجهة التي تنشر البيانات الأصلية.
meta.sources[].source_urlstringصفحة نشر المصدر أو التعريف ببياناته.
meta.sources[].resource_urlstringرابط الملف أو المورد المستخدم فعلياً.
meta.sources[].licensestringرخصة إعادة الاستخدام. تعني mixed وجود رخص مختلفة: راجع كل مصدر.
القيم المقبولة:
"Apache-2.0"meta.sources[].source_updated_atstring | nullآخر تحديث معلن من المصدر؛ وليس تاريخ جلب الملف.
الأخطاء
400: معامل غير صالح أو مفقود.
تتضمن الأخطاء error.code وerror.message وerror.request_id.
errorobjectتفاصيل الطلب الفاشل؛ تحل محل data وmeta.
error.codestringرمز ثابت للخطأ، مثل RESOURCE_NOT_FOUND؛ استعمله في منطق التطبيق.
error.messagestringشرح مقروء للخطأ؛ استعمل code في منطق التطبيق.
error.request_idstringمعرّف هذا الطلب، يفيد عند الإبلاغ عن مشكلة.