الانتقال إلى المحتوى

// post /v1/bulk/phone-validator

Bulk Phone Validator API

تحقق من مجموعات أرقام الهاتف الكبيرة ووحّدها في عملية API واحدة غير متزامنة مصممة للتوسع.

Phone numbers, with an optional countryحتى 10,000 صف
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 01 · الطلب

Phone Validator مجمّع هو طلب HTTPS واحد

أرسل المعاملات مع مفتاحك وسرّك. كل SDK وCLI وخادم MCP ينفّذون هذا الاستدعاء نفسه.

type
phone-validator
list | data | file
Phone numbers, with an optional country
launch
القيمة true تبدأ المهمة فورًا
webhook_url
يستقبل حدثًا موقّعًا عند انتهاء المهمة
rows
حتى 10,000 لكل مهمة
curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

// 02 · الاستجابة

ما يُعاد إليك

JSON، متطابقة في كل لغة. الحقول التي لا تعرفها Tomba تكون null، ولا تُخمَّن أبدًا.

GET/phone-validator
dataobject | array
The number's details; an empty array, with phone repeating your input, when it isn't valid
data.validboolean | null
Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null
The number in international, E.164 and national formats
data.country_codestring | null
Country of the number (ISO code)
data.line_typestring | null
MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null
The network operator
data.region, data.timezonesobject | null, array | null
Where the number is registered, and its time zones
POST /bulk/phone-validator
201 Created
{
  "data": {
    "id": 1042
  }
}
كل صف، كما يعيده GET /phone-validator
200 OK
{
  "data": {
    "valid": true,
    "local_format": "(650) 555-0132",
    "intl_format": "+1 650-555-0132",
    "e164_format": "+16505550132",
    "rfc3966_format": "tel:+1-650-555-0132",
    "country_code": "US",
    "line_type": "MOBILE",
    "carrier": "AT&T",
    "region": {
      "name": "California",
      "code": "CA"
    },
    "timezones": [
      "America/Los_Angeles"
    ]
  }
}

// 03 · التكلفة والحدود

تكلفة الاستدعاء

لا يُخصم الاستدعاء إلا وفق الشرط أدناه. تعتمد حدود المعدّل على خطتك.

// التكلفة

1 search credit per valid number.

Charged once, at the first download; later downloads are free

  • Jobs created: 15 per day for each type
  • Running jobs: 2 per type
  • Downloads: 25 per day for each job
  • Request size: 4 MB (CSV, list or rows)

// الأسئلة الشائعة

الأسئلة الشائعة

هل لديك أسئلة أخرى؟ زُر مركز المساعدة

// ابدأ مجانًا

اكتشف من يجده Tomba في أي شركة

اكتب نطاق شركة لترى موظفيها وأدوارهم وعناوين بريدهم المهنية الموثّقة، مع الصفحات التي وُجد عليها كل عنوان. حساب مجاني، دون بطاقة.