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

فحص الرمز

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

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

الترويسات

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 مع كل فحص. إذا ضاع الرد، أعد بنفس المفتاح لتحصل على الرد الأصلي.