دليل تأكيد
تأكيد يرسل رموز التحقق (OTP) عبر الواتساب، والإشعارات إلى أندرويد وiOS والويب، من حساب واحد. الإشعارات مجانية وبلا حدود. كل رمز واتساب يستهلك رصيدًا واحدًا، وشركتك الأولى تأتي مع 5 رموز مجانًا.
في هذه الصفحة
اختر طريقك#
| أريد أن… | اقرأ | أول استدعاء |
|---|---|---|
| أرسل رموز تسجيل الدخول عبر الواتساب | رموز التحقق عبر الواتساب | POST /api/v1/otp/send |
| اعرف عدد رسائل OTP المتاحة للتطبيق | رموز التحقق عبر الواتساب | GET /api/v1/otp/balance |
| أرسل إشعارات إلى تطبيق Flutter | البدء السريع: Flutter | Takeed.initialize(appId) |
| أرسل إشعارات إلى موقع ويب | البدء السريع: الويب | Takeed.init({ appId }) |
| أنتقل من OneSignal | الانتقال من OneSignal | غيّر الرابط والمفتاح |
أول رمز لك#
-
أنشئ حسابًا برقم الواتساب، وأدخل اسم الشركة، ثم أضف تطبيقًا.
-
افتح التطبيق ثم الإعدادات ← إعدادات OTP ← الربط البرمجي — Authorization وأنشئ مفتاحًا. يظهر المفتاح مرة واحدة فقط، فاحفظه على خادمك.
-
افتح رصيد الرسائل في الشركة، وانقل رمز OTP واحدًا على الأقل إلى التطبيق، ثم أرسل رمزًا إلى رقمك:
curl https://takeed-iq.com/api/v1/otp/send \ -H "Authorization: Key $TAKEED_KEY" \ -H "Content-Type: application/json" \ -d '{"phone": "+9647701234567", "code": "482913", "user_ip": "203.0.113.7"}'
يظهر الرمز في لوحة التحكم ضمن رموز OTP عبر الواتساب، وتتقدّم علاماته أمامك: أُرسلت، ثم وصلت، ثم مقروءة. وتجد الباقي في دليل رموز التحقق عبر الواتساب.
المفاهيم الأساسية#
| المفهوم | معناه |
|---|---|
| الشركة | مساحة عمل حسابك. تضم التطبيقات والأعضاء ومحفظة الرسائل. |
| التطبيق | منتج واحد. له App ID ورصيد OTP مستقل ومفاتيح إشعارات ومستخدمو إشعارات. |
| الفرع | جزء من التطبيق (شركة أو موقع). يمكن أن يكون له مفتاح API وحدّ متابعة شهري اختياري، ويستخدم مفاتيح إشعارات التطبيق ما لم تكن له مفاتيحه. |
| مفتاح API | المفتاح السري المستخدم بالشكل Authorization: Key <key>. أنشئه داخل التطبيق من الإعدادات ← إعدادات OTP ← الربط البرمجي — Authorization. يظهر كاملًا مرة واحدة فقط. |
| target | اختياري مع مفتاح التطبيق. استخدم "app:branch" عندما تريد تنفيذ الطلب على فرع بعينه. |
الرصيد والحدود#
الإشعارات لا تستهلك رصيدًا ولا حدّ لها. يدخل رصيد OTP أولًا إلى محفظة الشركة، ثم ينقل مسؤول الشركة
عددًا من الرموز إلى كل تطبيق. إذا وصل رصيد التطبيق إلى صفر يتوقف الإرسال بالخطأ
application_credit_exhausted حتى لو بقي رصيد في محفظة الشركة. وإذا لم يقبل مزوّد الخدمة الرسالة
يُعاد الرصيد إلى التطبيق نفسه.
تعرض محفظة الشركة الرصيد المتاح للتوزيع، ويعرض كل تطبيق رصيده الحالي. أما حدود الفروع، عند استعمالها، فهي حدود متابعة شهرية ولا تنشئ رصيدًا جديدًا.
أيضًا في هذا الدليل#
- تطبيق ويب واحد لكل النطاقات الفرعية: مفتاح واحد لمنصة فيها نطاق فرعي لكل شركة.
- إرسال الإشعارات: الاستهداف والأزرار والصور والجدولة.
- رموز الأخطاء: كل أسباب الرفض، مع حالة HTTP لكل منها.
- مرجع الواجهة البرمجية: كل نقاط النهاية، مولَّدة من الكود مباشرة.