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

    عربي أو إنجليزي · ↑↓ للتنقل · Enter للفتح · Esc للقفل

    English
    في الصفحة دي

    الأرقام

    التأكد إن الأرقام عليها واتساب (1–50)

    POST/v2/numbers/{numberId}/contacts/check
    • الصلاحية:numbers:read
    • Idempotency-Key:اختياري
    • بيصرف رصيد

    من الكاش الأول (30 يوم) وبعدين بحث مباشر في حدود كل دقيقة عشان نحمي رقمك.

    البارامترات

    المسار

    الاسمالنوعالقيودالوصف
    numberIdإجباريالنوعstringالقيود—الوصفرقم الـ id بتاع الرقم (من GET /v2/numbers).

    الهيدرز

    الاسمالنوعالقيودالوصف
    Idempotency-Keyاختياريالنوعstringالقيود≤ 191 حرفالوصفid فريد من عندك للعملية دي (حد أقصى 191 حرف ASCII). لو كررت بنفس المفتاح ونفس الـ body بيرجعلك أول رد ومعاه Idempotent-Replayed: true — عمرها ما تتنفذ مرتين. بيتحفظ 24 ساعة.
    X-Request-Idاختياريالنوعstringالقيود—الوصفاختياري: id الطلب بتاعك وبيرجعلك (غير كده بنعمل req_…). اديه للدعم لو احتجت.

    الـ Body

    الاسمالنوعالقيودالوصف
    phonesإجباريالنوعstring[]القيود≤ 50 عنصرالوصفمن 1 لـ 50 رقم. الإجابات المتخزنة (30 يوم) الأول؛ والسؤال المباشر بميزانية في الدقيقة بتحمي رقمك.

    الطلب

    curl -X POST "https://mursilat.com/api/v2/numbers/cm1abcd2345efgh6789ijkl/contacts/check" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "phones": [
        "201001234567",
        "966501234567"
      ]
    }'
    الطلب — JSON
    {
      "phones": [
        "201001234567",
        "966501234567"
      ]
    }

    الرد

    200مثال

    200 — application/json
    {
      "data": [
        {
          "input": "201001234567",
          "phone": "201001234567",
          "onWhatsApp": true,
          "jid": "201001234567@s.whatsapp.net",
          "status": "ON_WHATSAPP"
        }
      ],
      "checked": 1,
      "fromCache": 1,
      "unknown": 0
    }

    شكل الرد

    حقول الرد في المثال. افتح الكائنات والقوايم.

    • responseobject4 حقل
      • dataarray1 عنصر
        • [0]object5 حقل
          • inputstring "201001234567"
          • phonestring "201001234567"
          • onWhatsAppboolean true
          • jidstring "201001234567@s.whatsapp.net"
          • statusstring "ON_WHATSAPP"
      • checkedinteger 1
      • fromCacheinteger 1
      • unknowninteger 0

    الأخطاء

    غير أخطاء المصادقة وحدود الطلبات والتحقق اللي ممكن ترجع من أي endpoint:

    الأخطاء →

    حماية الرقم والسلوك

    السؤال المباشر عليه ميزانية في الدقيقة عشان يحمي الرقم؛ أكتر من 50 رقم في الطلب بيرد 422 CONTACT_CHECK_TOO_MANY — الحملات بتفحص القوايم الكبيرة على دفعات آمنة لوحدها.

    جرّب

    ابعت الطلب ده من متصفحك لـ API مرسلات.

    مثال موثّق

    معاينة — النسخة دي من التوثيق مش على mursilat.com، فالكونسول بيعرض المثال الموثّق بدل ما يكلم الـ API.

    الطلبات الحقيقية بتستخدم رقمك وباقتك الحقيقيين: ممكن تبعت رسايل واتساب وتصرف من رصيدك وتمسح بيانات. (بيصرف رصيد)

    متخزن في ذاكرة التبويب ده بس: عمره ما بيتحفظ ولا بيتحط في الرابط، وبيتبعت لـ mursilat.com بس. لو عملت reload بيتنسي.

    بارامترات المسار

    تبعت الطلب ده بجد؟

    ده بيصرف من رصيد باقتك.

    POST /v2/numbers/{numberId}/contacts/check