إرسال الإشعارات

يقبل تأكيد صيغة إرسال قريبة من OneSignal. في خادمك غيّر الرابط والمفتاح، ثم أرسل الطلب التالي:

curl https://takeed-iq.com/api/v1/notifications \
  -H "Authorization: Key $TAKEED_KEY" -H "Content-Type: application/json" \
  -d '{
    "app_id": "YOUR-APP-ID",
    "target": "shop:north",
    "headings": {"en": "Order shipped", "ar": "تم شحن الطلب"},
    "contents": {"en": "Arrives tomorrow", "ar": "يصل غداً"},
    "include_aliases": {"external_id": ["user-42"]},
    "data": {"order_id": "7"},
    "buttons": [{"id": "track", "text": "تتبّع"}],
    "big_picture": "https://cdn.example.com/box.jpg"
  }'

يكون الرد مثل: {"id":"...","recipients":1,"status":"queued"}. احتفظ بالـ id إذا أردت جلب التفاصيل أو إلغاء إشعار مجدول.

الجمهور#

يجب اختيار جمهور واحد على الأقل. لا تضع مفتاح API داخل تطبيق الهاتف أو المتصفح؛ عملية الإرسال تتم من خادمك أو من لوحة تأكيد.

الحقول المدعومة#

app_id، headings، contents، subtitle، include_aliases.external_id، include_external_user_ids، target_channel (القيمة push فقط)، included_segments، excluded_segments، filters، data، url، web_url، app_url، big_picture، large_icon، small_icon، chrome_web_icon، chrome_web_image، chrome_web_badge، ios_attachments، buttons (حتى 3)، web_buttons (حتى 2)، android_channel_id، android_accent_color، android_sound، android_group، ios_sound، ios_badgeType، ios_badgeCount، thread_id، ios_interruption_level، send_after، ttl، priority وcollapse_id.

يمكن جدولة الإرسال حتى 30 يومًا مقدمًا. قيمة ttl بين 0 و2419200 ثانية، وpriority بين 0 و10.

الرصيد#

الإشعارات مجانية وبلا حدود. لا تُخصم من محفظة الشركة ولا من رصيد OTP الخاص بالتطبيق.

سجل الإشعارات والتفاصيل#

تعرض صفحة سجل الإشعارات عدد المستلمين والمرسل والواصل والفاشل والمفتوح. افتح تفاصيل الإشعار لرؤية المستلمين وأنواع أجهزتهم ومنصاتهم وحالة كل محاولة وسبب الفشل المبسّط، مثل: مفتاح ناقص، بيانات اعتماد غير صحيحة، تطبيق محذوف، طلب مرفوض أو جهاز غير قابل للوصول.

نقاط نهاية أخرى#

• GET /api/v1/notifications?app_id=…: قائمة الإشعارات، بحد أقصى 50 في الطلب.
• GET /api/v1/notifications/{id}?app_id=…: تفاصيل الإشعار وأعداد الإرسال والوصول والفتح.
• DELETE /api/v1/notifications/{id}?app_id=…: إلغاء إشعار مجدول أو ما زال قيد الإرسال.
• GET /api/v1/apps/{app_id}/segments: عرض الشرائح، ويمكن استخدامه للتحقق من صلاحية المفتاح.
• /api/v1/apps/{app_id}/users/by/external_id/{id}: قراءة مستخدم وتعديل وسومه أو حذفه.

راجع رموز الأخطاء لمعاني no_audience وinvalid_filter وsegment_not_found وغيرها.