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_….

سەرپەڕەکان (Headers)

  • 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.