ارسال اعلان‌های وب (Push Notification) برای سایت و اپلیکیشن شما

۱) نصب کد اشتراک (Subscribe) در سایت

برای اینکه بازدیدکنندگان سایت شما بتوانند در اعلان‌ها مشترک شوند، کافی است آن‌ها را به آدرس زیر هدایت کنید (یا این آدرس را در یک iframe / پاپ‌آپ قرار دهید):

https://YOUR-DOMAIN/public/subscribe.php?account=YOUR_ACCOUNT_KEY

۲) ارسال اعلان از طریق API

درخواست POST با بدنه JSON و هدر Authorization به آدرس زیر ارسال کنید:

POST /public/api/notifications/send.php
Content-Type: application/json
Authorization: Bearer YOUR_API_SECRET

فیلد	الزامی	توضیح
account_key	بله	کلید ۱۰ کاراکتری اکانت
title	بله	عنوان اعلان (حداکثر ۲۵۵ کاراکتر)
message	بله	متن اعلان (حداکثر ۴۰۰۰ کاراکتر)
category	خیر	یکی از: critical، urgent، notice، normal، history (پیش‌فرض normal)
notification_url	خیر	لینک مقصد پس از کلیک روی اعلان
external_id	خیر	شناسه یکتای شما برای پیگیری
metadata	خیر	یک آبجکت JSON دلخواه

نمونه با curl:

curl -X POST https://YOUR-DOMAIN/public/api/notifications/send.php \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_SECRET" \
  -d '{
    "account_key": "YOUR_ACCOUNT_KEY",
    "title": "پست جدید منتشر شد",
    "message": "یک مطلب تازه در سایت شما منتشر شد.",
    "category": "normal",
    "notification_url": "https://your-site.com/post/123"
  }'

نمونه با PHP:

<?php
$ch = curl_init('https://YOUR-DOMAIN/public/api/notifications/send.php');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer YOUR_API_SECRET',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'account_key' => 'YOUR_ACCOUNT_KEY',
        'title' => 'پست جدید منتشر شد',
        'message' => 'یک مطلب تازه در سایت شما منتشر شد.',
        'category' => 'normal',
        'notification_url' => 'https://your-site.com/post/123',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
// $response['success'], $response['notification_id'], $response['cost'] ...

پاسخ موفق با کد ۲۰۱ همراه با notification_id و cost (مبلغ کسر شده از کیف پول) برگردانده می‌شود. در صورت ناکافی بودن موجودی کیف پول، کد ۴۰۲ و error: insufficient_balance بازگردانده می‌شود و به‌جای اعلان اصلی، پیام «عدم شارژ حساب» برای مشترکین ارسال می‌گردد.