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

فحص الرمز

تحقق من الرمز الذي كتبه المستخدم. كل فحص يُحسب محاولة.

POSThttps://watsy.me/v1/verify/{id}/check

فحص الرمز

curl -X POST https://watsy.me/v1/verify/5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11/check \
  -H "Authorization: Bearer $WATSY_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: check-8841-1" \
  -d '{
    "code": "482913"
  }'

وەڵام

{
  "id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
  "object": "verification_check",
  "valid": true,
  "status": "verified",
  "attempts": 1,
  "attempts_remaining": 4,
  "verified_at": "2026-10-28T10:01:12.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.

ناوەڕۆکی داواکاری

application/json

codestringپێویستە
الرمز كما كتبه المستخدم: من 4 إلى 8 أرقام. المسافات في الطرفين تُحذف.

وەڵام (200)

application/json

idstringپێویستە
معرّف عملية التحقق.
objectstringپێویستە
دائماً verification_check.
validbooleanپێویستە
النتيجة الوحيدة التي تعتمد عليها.
statusstringپێویستە
حالة العملية بعد الفحص.
بەهاکان:pendingsentverifiedfailedexpiredcanceled
attemptsintegerپێویستە
الفحوصات حتى الآن.
attempts_remainingintegerپێویستە
الفحوصات المتبقية.
verified_atstring | nullپێویستە
وقت التحقق الناجح.

قواعد الفحص

اعتمد على valid فقط. الرمز الخاطئ يرجع 200 مع valid: false، وليس خطأ HTTP.
عند بلوغ max_attempts تُقفل العملية بحالة failed، ويُرفض بعدها حتى الرمز الصحيح.
بعد انتهاء الصلاحية: valid: false مع status: "expired". العمليات الملغاة أو الفاشلة ترجع valid: false دون أن تُحسب محاولة.
الرمز يُستهلك مرة واحدة: فحص عملية ناجحة مرة ثانية يرجع valid: false مع status: "verified".

أرسل Idempotency-Key مع كل فحص. إذا ضاع الرد، أعد بنفس المفتاح لتحصل على الرد الأصلي.