پرش به مطلب اصلی

شروع سریع

در این راهنما با کمترین گام ممکن، اولین پیامک الگویی را از طریق وب‌سرویس ارسال می‌کنید. مثال‌ها از کلید API استفاده می‌کنند، زیرا ساده‌ترین روش احراز هویت است. اگر برنامه‌ی شما برای چند مشتری جداگانه کار می‌کند، به اتصال برنامه‌های چندمشتری مراجعه کنید.

پیش‌نیازها​

  • یک حساب کاربری فعال در پایاوا با اعتبار کافی
  • یک کلید API ساخته‌شده در پنل؛ نگاه کنید به کلید API در پنل
  • یک الگوی مجاز و کد عددی آن؛ فهرست الگوها را با الگوها دریافت می‌کنید

گام ۱: بررسی اتصال و موجودی​

با فراخوانی دریافت موجودی مطمئن شوید کلید شما پذیرفته می‌شود:

curl -X GET "https://api.payavasms.com/sms/api/Balance" \
-H "X-Api-Key: YOUR_API_KEY"

در صورت موفقیت، status برابر 0 است و موجودی در data قرار دارد.

گام ۲: یافتن الگو​

الگوهای قابل استفاده‌ی خود را بخوانید و مقدار code و کلیدهای parameters الگوی دلخواه را بردارید:

curl -X GET "https://api.payavasms.com/sms/api/MsgFormat/User/0/20" \
-H "X-Api-Key: YOUR_API_KEY"

گام ۳: ارسال پیامک​

کد الگو، شماره‌ی گیرنده و مقدار پارامترها را ارسال کنید:

curl -X POST "https://api.payavasms.com/api/Message/SendMessage" \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"code": 123456789012,
"lineNumber": "YOUR_LINE_NUMBER",
"recipients": [
{
"phoneNumber": "09120000000",
"parameters": [
{
"key": "name",
"value": "علی"
},
{
"key": "code",
"value": "5821"
}
]
}
]
}'

پاسخ موفق به این شکل است:

{
"status": 0,
"message": "عملیات با موفقیت انجام شد.",
"data": {
"result": {
"messages": [
{
"registerCode": 10000001,
"phoneNumber": "989120000000",
"parts": 1
}
]
},
"platform": "Sms"
}
}

جزئیات کامل فیلدها در ارسال پیامک و فهرست خطاها در کدهای وضعیت و خطاها آمده است.

گام‌های بعدی​