API تأیید پیامکی برای توسعهدهندگان: شروع کار
اگر جریان ثبتنام برنامهتان را آزمایش میکنید یا تأیید را خودکار کردهاید، API به شما امکان میدهد هر کاری را که پنل انجام میدهد، بدون باز کردن آن انجام دهید.
قبل از شروع
کلید خود را از صفحهٔ API در پنلتان دریافت کنید. کلید را در مخزن کد (repository) ذخیره نکنید؛ آن را در یک متغیر محیطی نگه دارید.
جریان پایه
- فهرست سرویسها و کشورها را دریافت کنید.
- یک شماره بخرید.
- وضعیت را در فواصل زمانی بررسی کنید (polling) یا از webhook استفاده کنید.
- وقتی کد رسید، فعالسازی را کامل کنید؛ اگر نرسید، آن را لغو کنید.
نکاتی که باید به خاطر بسپارید
- در تلاشهای مجدد، هدر
Idempotency-Keyرا ارسال کنید. اگر پس از خطای شبکه با همان کلید دوباره تلاش کنید، شماره دوم خریداری نمیشود. - محدودیت نرخ درخواست (rate limit) را رعایت کنید؛ بیدلیل فاصلهٔ بررسی وضعیت را کوتاه نکنید.
- پاسخهای موجودی ناکافی و ناموجود بودن را در کد خود جداگانه مدیریت کنید.
اگر نرمافزار شما از پروتکل سازگار با SMS-Activate استفاده میکند، میتوانید بدون تغییر کد، از طریق endpointهای سازگار متصل شوید. همهٔ جزئیات در مستندات API آمده است.
بدون اشتراکگذاری شماره واقعیتان تأیید کنید
مشاهده قیمتها
شمارههای یکبارمصرف برای صدها سرویس؛ در صورت دریافت نکردن کد، مبلغ بازگردانده میشود.