Anza haraka kutoka ukurasa huu bila kutafuta sehemu nyingi kwenye jukwaa.
Base URL safi, auth header, mifano tayari, webhooks na error codes katika uzoefu uliopangwa.
Anza haraka kutoka ukurasa huu bila kutafuta sehemu nyingi kwenye jukwaa.
Chagua scenario sahihi kisha endesha request ya kwanza kwa cURL au snippets tayari.
Pokea callbacks za sent, delivered na failed ndani ya mfumo wako pamoja na retries na log inayoonekana.
Fuatilia devices, afya ya queue na hali ya ujumbe bila kuondoka kwenye uzoefu huo huo.
Tumia endpoints mbili za haraka wakati wa development au CI kuthibitisha kuwa service iko hai na account iko tayari kwa traffic halisi.
{
"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
}
Tumia faili la OpenAPI na collection ya Postman kuweka developers na operations kwenye mstari mmoja.
Failures muhimu zinapaswa kurudi kwenye mfumo wako kupitia webhooks na retry log iliyo wazi.
Jaribu health, readiness na app pairing kabla ya launch ya kwanza ya production.
Tuma SMS ya miamala kupitia queue ukiwa na device routing na ufuatiliaji wa hali.
Tuma OTP ikiwa na purpose, locale na muda wa kuisha ulio wazi.
Thibitisha msimbo na urudishe success/failed/expired kwa uwazi.
Soma status ya ujumbe, attempts na sababu za failure kwa request_id.
Soma saraka ya wapokeaji waliohifadhiwa na utafute kwa jina au nambari.
Weka orodha nzima kwenye queue; kila nambari itakuwa item tofauti.
unauthorizedAPI key au auth header si sahihi.
invalid_deviceKifaa hakipatikani au si halali kwa routing.
rate_limitedSending limits au safety thresholds zimevukwa.
queue_blockedUtumaji umezuiwa kwa muda na hali ya queue au policies.
subscription_expiredUsajili umeisha na unahitaji kufanywa upya.
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.