شروع سریع: دریافت توکن و اولین درخواست

قدم ۱) دریافت توکن دسترسی

پس از ورود به پنل کاربری، از بخش توسعه‌دهندگان / کلیدهای دسترسی، یک توکن بسازید و آن را در سمت سرور نگه‌داری کنید.

قدم ۲) بررسی اعتبار توکن

برای اطمینان از صحت توکن، درخواست زیر را ارسال کنید:

curl --location "https://nivasms.com/v1/api/acl/auth/check_token" \
  --header "Content-Type: application/json" \
  --header "Authorization: YOUR_TOKEN"

نکته: توکن را در کدهای سمت کلاینت (JS) قرار ندهید.

قدم ۳) ارسال اولین پیامک (وب‌سرویس)

POST https://nivasms.com/v1/api/send
Authorization: YOUR_TOKEN
Content-Type: application/json

{
  "sending_type": "webservice",
  "from_number": "+983000505",
  "message": "سلام! وب‌سرویس نیوا اس‌ام‌اس فعال شد.",
  "params": { "recipients": ["+989120000000"] }
}

پس از ارسال موفق، شناسه message_outbox_ids را برای پیگیری وضعیت نگه دارید.