رفتن به محتوای اصلی
ارسال پیامک (نسخهٔ ۱)

ارسال آرایه‌ای پیامک (پیاده‌سازی نشده)

post
https://sms.najva.com/v1/{apiKey}/sms/sendarray.json

احراز هویت: این سرویس کلید API را از مسیر URL می‌خواند (/v1/{apiKey}/...) و هدر احراز هویتی ندارد. درخواست فقط از آی‌پی‌های وایت‌لیست‌شده پذیرفته می‌شود. به احراز هویت و وایت‌لیست IP نگاه کنید.

این مسیر در سرویس فعلی پیاده‌سازی نشده است. هندلر آن (Controller.SendArrayMessage در api/controller/sms.go:16) هیچ پارامتری را نمی‌خواند، هیچ اعتبارسنجی‌ای انجام نمی‌دهد و هیچ پیامکی ارسال نمی‌کند؛ صرفاً HTTP 200 با بدنهٔ null برمی‌گرداند.

میان‌افزارهای گروه /v1/ (احراز هویت با کلید API در مسیر و بررسی IP مجاز) پیش از هندلر اجرا می‌شوند، بنابراین خطاهای احراز هویت و IP همچنان می‌توانند رخ دهند و در این حالت پاسخ، پوشش استاندارد خطا است. برای ارسال پیامک از /v1/{apiKey}/sms/send.json استفاده کنید.

این مسیر با متد GET هم ثبت شده و رفتار یکسانی دارد؛ در مستندات فقط شکل POST نشان داده شده است.

پارامترهای مسیر

۱
نامنوعالزامیتوضیح
apiKey*
stringالزامی

کلید API حساب کاربری که به‌صورت بخشی از مسیر ارسال می‌شود (نه هدر).

نمونهa1b2c3d4e5f60718293a4b5c6d7e8f90

پاسخ‌ها

ساختار پاسخ

نامنوعالزامیتوضیح
return
ApiStatusاختیاری

وضعیت پاسخ. مقدار status با کد وضعیت HTTP پاسخ یکسان است.

status*
integerالزامی

کد وضعیت — همان کد وضعیت HTTP پاسخ.

نمونه200
message*
stringالزامی

پیام فارسی قابل نمایش به کاربر.

نمونهدرخواست تایید شد.
entries
objectاختیاری

ساختار پاسخ در کد سرویس تعریف نشده است.

نمونهٔ پاسخ

{
"return": {
"status": 200,
"message": "درخواست تایید شد."
},
"entries": {}
}