پلیٹ فارم کے مختلف حصوں میں ڈھونڈے بغیر اسی صفحے سے فوراً شروع کریں۔
منظم تجربے کے اندر صاف Base URL، auth header، مثالیں، webhooks اور error codes۔
پلیٹ فارم کے مختلف حصوں میں ڈھونڈے بغیر اسی صفحے سے فوراً شروع کریں۔
مناسب scenario منتخب کریں پھر پہلا request cURL یا ready snippets کے ذریعے چلائیں۔
اپنے سسٹم میں sent، delivered اور failed callbacks retries اور واضح attempt log کے ساتھ وصول کریں۔
اسی تجربے سے نکلے بغیر devices، queue health اور message state دیکھیں۔
development یا CI کے دوران دو تیز endpoints استعمال کریں تاکہ service چلنے اور account کے real traffic کے لیے تیار ہونے کی تصدیق ہو۔
{
"ok": true,
"request_id": "req_01H...",
"status": "queued",
"queued_at": "2026-03-14T12:30:00Z"
}
{
"ok": true,
"otp_id": "otp_01H...",
"status": "sent",
"expires_in_seconds": 300
}
{
"ok": true,
"request_id": "req_01H...",
"status": "delivered",
"device_name": "Relay Device 1",
"attempts": 1
}
developer اور operations ٹیم کو aligned رکھنے کے لیے OpenAPI فائل اور Postman collection استعمال کریں۔
اہم failures Webhooks اور واضح retry log کے ساتھ آپ کے سسٹم میں واپس آنے چاہئیں۔
پہلے production launch سے پہلے health، readiness اور app pairing ٹیسٹ کریں۔
queue کے ذریعے device routing اور status tracking کے ساتھ transactional SMS بھیجیں۔
OTP کو purpose، locale اور واضح expiry کے ساتھ بھیجیں۔
کوڈ verify کریں اور success/failed/expired واضح طور پر واپس کریں۔
request_id کے ذریعے message status، attempts اور failure reasons دیکھیں۔
محفوظ recipients directory دیکھیں اور نام یا نمبر سے تلاش کریں۔
مکمل فہرست queue میں ڈالیں، ہر نمبر الگ queue item بن جائے گا۔
unauthorizedAPI key یا auth header درست نہیں ہے۔
invalid_deviceڈیوائس دستیاب نہیں یا routing کے لیے درست نہیں۔
rate_limitedsending limits یا safety thresholds تجاوز ہو گئے ہیں۔
queue_blockedqueue state یا policies کی وجہ سے ارسال عارضی طور پر روکا گیا ہے۔
subscription_expiredسبسکرپشن ختم ہو چکا ہے اور renew درکار ہے۔
It fits login systems, stores, bookings, invoices, and operational alerts that need OTP or event-driven messaging, not mass marketing campaigns.
Yes. Ready-to-copy examples include cURL, PHP, Laravel, Node, Axios, Python, Flutter, Kotlin, Java, C#, Go, and Ruby.
Yes. You can rely only on Send OTP and Verify OTP if your project needs verification without other messaging flows.
The device should preferably stay online with permissions and foreground service enabled so sending and status heartbeat continue normally.
Start by creating the account, pairing the Android Relay, taking an access token, then running your first request from the ready examples before moving to webhooks and production.
واٹس ایپ