التحقق والرسائل
حالة عملية التحقق
اقرأ حالة العملية وكل محاولات الإرسال وتكلفتها.
https://watsy.me/v1/verify/{id}curl https://watsy.me/v1/verify/5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11 \
-H "Authorization: Bearer $WATSY_KEY"{
"id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
"object": "verification",
"mode": "live",
"phone": "+9647701234567",
"status": "verified",
"channel": "telegram",
"channels": [
"whatsapp",
"telegram",
"sms"
],
"attempts": 1,
"max_attempts": 5,
"attempts_remaining": 4,
"locale": "ar",
"metadata": {
"user_id": 8841
},
"expires_at": "2026-10-28T10:05:00.000Z",
"verified_at": "2026-10-28T10:01:12.000Z",
"created_at": "2026-10-28T10:00:00.000Z",
"price_milli": 18000,
"messages": [
{
"id": "0b6f6a3e-1c2d-4e5f-8a9b-1c2d3e4f5a6b",
"object": "message",
"verification_id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
"channel": "whatsapp",
"provider": "meta_cloud",
"status": "failed",
"error_code": "whatsapp_131026",
"price_milli": 0,
"created_at": "2026-10-28T10:00:00.000Z",
"updated_at": "2026-10-28T10:00:01.000Z"
},
{
"id": "7e1d2c3b-4a59-4687-9a0b-c1d2e3f4a5b6",
"object": "message",
"verification_id": "5d3c1f0e-7a1b-4c55-9a7e-2f1d6b0c9e11",
"channel": "telegram",
"provider": "telegram_gateway",
"status": "sent",
"error_code": null,
"price_milli": 18000,
"created_at": "2026-10-28T10:00:01.000Z",
"updated_at": "2026-10-28T10:00:02.000Z"
}
]
}ناسینەوە
Authorizationstring (header)پێویستەBearerثم مفتاح المشروع:wsy_live_…أوwsy_test_….
سەرپەڕەکان (Headers)
X-Request-Idstringاختياري، 8 إلى 64 حرفاً. نعيده في الرد، وإلا نولّد واحداً.
پارامیتەرەکانی ڕێڕەو
idstring (uuid)پێویستەمعرّف عملية التحقق كما رجع من
POST /v1/verify.
وەڵام (200)
application/jsonidstringپێویستەمعرّف عملية التحقق (UUID).
objectstringپێویستەدائماً
verification.modestringپێویستەنوع المفتاح الذي أنشأ العملية.
بەهاکان:
livetestphonestringپێویستەالرقم بصيغة E.164 بعد التوحيد.
statusstringپێویستەحالة العملية. انظر جدول الحالات.
بەهاکان:
pendingsentverifiedfailedexpiredcanceledchannelstring | nullپێویستەآخر قناة جُرّبت، أو التي وصل منها الرمز.
channelsstring[]پێویستەسلسلة القنوات المطلوبة بالترتيب.
attemptsintegerپێویستەعدد الفحوصات حتى الآن.
max_attemptsintegerپێویستەحد الفحوصات من إعدادات المشروع (الافتراضي 5).
attempts_remainingintegerپێویستەالفحوصات المتبقية.
localestringپێویستەلغة الرسالة.
بەهاکان:
arenmetadataobjectپێویستەبياناتك كما أرسلتها، أو
{}.expires_atstringپێویستەنهاية صلاحية الرمز.
verified_atstring | nullپێویستەوقت التحقق الناجح.
created_atstringپێویستەوقت الإنشاء.
price_milliintegerپێویستەصافي ما خُصم لكل المحاولات بالـ milli-IQD (1 دينار = 1000).
messagesmessage[]پێویستەمحاولة لكل قناة جُرّبت، بالترتيب.
پیشاندانی خانە لاوەکییەکانشاردنەوەی خانە لاوەکییەکان
idstringمعرّف محاولة الإرسال.
objectstringدائماً
message.verification_idstringعملية التحقق التي تتبعها المحاولة.
channelstringالقناة.
بەهاکان:
whatsapptelegramsmsproviderstringالمزوّد الذي نفّذ المحاولة:
meta_cloud(رقم Watsy على واتساب)،whatsapp_own(رقمك الخاص)،telegram_gateway، أوtestفي وضع الاختبار.statusstringdeliveredيظهر عندما يرسل المزوّد تقرير تسليم (واتساب حالياً).بەهاکان:
pendingsentdeliveredfailederror_codestring | nullسبب الفشل من المزوّد، مثل
whatsapp_131026أوtelegram_PHONE_NUMBER_INVALIDأوtimeout.price_milliintegerصافي ما خُصم لهذه المحاولة بالـ milli-IQD. المحاولة المُستردّة تظهر 0.
created_atstringوقت الإنشاء (ISO 8601، UTC).
updated_atstringآخر تحديث.
الحالات
| الحالة | المعنى |
|---|---|
pending | قيد الإرسال |
sent | وصل الرمز لقناة وينتظر الفحص |
verified | تم التحقق بنجاح |
failed | فشلت كل القنوات، أو استُنفدت المحاولات |
expired | انتهت الصلاحية قبل التحقق |
canceled | ألغيتها أنت |
العمليات التي انتهت صلاحيتها تتحول إلى expired عند قراءتها أو بمهمة دورية، ويصلك الحدث verification.expired. مفتاح الاختبار لا يرى عمليات حقيقية والعكس (404).