Watsy
التحقق والرسائلإلغاء عملية تحقق

التحقق والرسائل

إلغاء عملية تحقق

أغلق عملية مفتوحة حتى لا يُقبل رمزها، مثلاً عند إعادة الإرسال.

POSThttps://watsy.me/v1/verify/{id}/cancel
curl -X POST https://watsy.me/v1/verify/5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11/cancel \
  -H "Authorization: Bearer $WATSY_KEY"
{
  "id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
  "object": "verification",
  "mode": "live",
  "phone": "+9647701234567",
  "status": "canceled",
  "channel": "telegram",
  "channels": [
    "whatsapp",
    "telegram",
    "sms"
  ],
  "attempts": 0,
  "max_attempts": 5,
  "attempts_remaining": 5,
  "locale": "ar",
  "metadata": {
    "user_id": 8841
  },
  "expires_at": "2026-10-28T10:05:00.000Z",
  "verified_at": null,
  "created_at": "2026-10-28T10:00:00.000Z"
}

المصادقة

  • Authorizationstring (header)إلزامي

    Bearer ثم مفتاح المشروع: wsy_live_… أو wsy_test_….

الترويسات

  • Idempotency-Keystring

    1 إلى 255 حرفاً. يمنع التكرار عند إعادة المحاولة خلال 24 ساعة. انظر Idempotency.

  • X-Request-Idstring

    اختياري، 8 إلى 64 حرفاً. نعيده في الرد، وإلا نولّد واحداً.

معطيات المسار

  • idstring (uuid)إلزامي

    معرّف عملية التحقق كما رجع من POST /v1/verify.

الرد (200)

application/json
  • idstringإلزامي

    معرّف عملية التحقق (UUID).

  • objectstringإلزامي

    دائماً verification.

  • modestringإلزامي

    نوع المفتاح الذي أنشأ العملية.

    القيم:livetest

  • phonestringإلزامي

    الرقم بصيغة E.164 بعد التوحيد.

  • statusstringإلزامي

    حالة العملية. انظر جدول الحالات.

    القيم:pendingsentverifiedfailedexpiredcanceled

  • channelstring | nullإلزامي

    آخر قناة جُرّبت، أو التي وصل منها الرمز.

  • channelsstring[]إلزامي

    سلسلة القنوات المطلوبة بالترتيب.

  • attemptsintegerإلزامي

    عدد الفحوصات حتى الآن.

  • max_attemptsintegerإلزامي

    حد الفحوصات من إعدادات المشروع (الافتراضي 5).

  • attempts_remainingintegerإلزامي

    الفحوصات المتبقية.

  • localestringإلزامي

    لغة الرسالة.

    القيم:aren

  • metadataobjectإلزامي

    بياناتك كما أرسلتها، أو {}.

  • expires_atstringإلزامي

    نهاية صلاحية الرمز.

  • verified_atstring | nullإلزامي

    وقت التحقق الناجح.

  • created_atstringإلزامي

    وقت الإنشاء.

  • بدون جسم، أو {}. أي حقل يرجع 400 validation_failed.
  • يلغي العمليات المفتوحة فقط (pending وsent). العملية المغلقة ترجع كما هي بنفس الرد 200.
  • لا يوجد استرداد، لأن الرمز أُرسل فعلاً. هذا الرد لا يحتوي messages ولا price_milli.