Mabilis na simula sa Developer API
Bumili ng mga numero at basahin ang mga code mula sa sarili mong software. Gumawa ng key, tingnan ang presyo, bumili ng numero, hintayin ang SMS at tapusin, hakbang-hakbang.
Sa pahinang ito
Binibigyan ng Developer API ng SmsGrab ang software mo ng parehong mga numerong nasa app, sa pamamagitan ng REST API na nakabatay sa JSON. Kaparehong presyo ng app ang babayaran mo, bawas ang wholesale discount mo, mula sa karaniwang balanse mo sa SmsGrab, at may parehong awtomatikong refund.
Sino ang puwedeng gumamit nito
- Email account na may na-confirm na address. Hindi puwedeng gumawa ng key ang guest account.
- Account na hindi pinaghihigpitan.
1. Gumawa ng API key
Buksan ang Account > Mga developer sa website, o ang Mga setting > Developer API sa app, at gumawa ng key. Para sa seguridad, magkukumpirma ka gamit ang password mo, at gamit ang code ng 2-step na pag-verify kung naka-on ito. Piliin ang scope na read para sa mga tool na nagbabasa lang, o read at purchase para bumili ng mga numero.
Nagsisimula ang key sa sgk_ at isang beses lang itong ipinapakita. Itabi ito sa secret storage ng server mo. Tingnan ang Mga API key at seguridad.
2. Authentication
Ang base URL ay https://smsgrab.com/api/dev/v1. Ipadala ang key bilang bearer token, o sa header na X-Api-Key:
GET /api/dev/v1/balance HTTP/1.1
Host: smsgrab.com
Authorization: Bearer sgk_your_key_here
Sa server nakalagay ang key. Huwag itong kailanman ilagay sa website, browser extension o app na ibinibigay mo sa ibang tao.
3. Tingnan ang balanse at mga presyo
export SMSGRAB_KEY="sgk_your_key_here"
curl -s https://smsgrab.com/api/dev/v1/balance \
-H "Authorization: Bearer $SMSGRAB_KEY"
curl -s "https://smsgrab.com/api/dev/v1/prices?service=whatsapp&country=indonesia" \
-H "Authorization: Bearer $SMSGRAB_KEY"
Palaging nakasaad ang pera sa pinakamaliit na yunit ng USD, kaya ang 24 ay nangangahulugang 0.24 USD. Ang price_minor ang presyo mo kasama ang wholesale discount at ang retail_price_minor ang list price sa app.
{ "currency": "USD", "discount_percent": 5,
"items": [ { "service_id": "whatsapp", "country_id": "indonesia", "price_minor": 24,
"retail_price_minor": 25, "available_numbers": 30412 } ] }
4. Bumili ng numero
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_KEY" \
-H "Idempotency-Key: order-7f3c2a" \
-H "Content-Type: application/json" \
-d '{"service":"whatsapp","country":"indonesia","max_price_minor":24}'
- Tumatanggap ang
serviceatcountryng mga id namin, gaya ngwhatsappatindonesia. Tumatanggap din ang country ng ISO code gaya ngID. - Pinoprotektahan ka ng
max_price_minor: kung tumaas ang presyo, walang ibabawas at makakakuha ka ng409 PRICE_CHANGED. - Ginagawang ligtas ng
Idempotency-Keyang pag-uulit. Kapag inulit ang request gamit ang parehong key, ibabalik ang unang resulta sa halip na bumili nang dalawang beses.
Ang sagot ay 201 Created kasama ang activation:
{ "id": "5c1d0c2e-8a41-4f7e-9d7a-2f1d9f1b8c11", "compat_id": 100000123, "status": "WAITING_SMS",
"service_id": "whatsapp", "country_id": "indonesia", "phone_number": "+6281234567890",
"price_minor": 24, "currency": "USD",
"created_at": "2026-09-27T10:05:00.000Z", "expires_at": "2026-09-27T10:25:00.000Z",
"refunded": false, "refund_minor": 0, "sms": [] }
5. Hintayin ang SMS
Sa halip na magtanong nang paulit-ulit sa mabilis na loop, hayaang hawakan ng API ang request nang hanggang 30 segundo hanggang may magbago:
curl -s "https://smsgrab.com/api/dev/v1/activations/100000123?wait=25" \
-H "Authorization: Bearer $SMSGRAB_KEY"
Kapag dumating ang mensahe, magiging CODE_RECEIVED ang status at laman ng sms ang lahat ng mensahe sa ngayon:
{ "status": "CODE_RECEIVED",
"sms": [ { "code": "482913", "text": "Your WhatsApp code is 482-913", "sender": "WhatsApp",
"received_at": "2026-09-27T10:06:12.004Z" } ] }
Mas gusto mo ba ang push kaysa polling? Mag-set up ng webhook.
6. Tapusin o kanselahin
curl -s -X POST https://smsgrab.com/api/dev/v1/activations/100000123/finish \
-H "Authorization: Bearer $SMSGRAB_KEY"
curl -s -X POST https://smsgrab.com/api/dev/v1/activations/100000123/cancel \
-H "Authorization: Bearer $SMSGRAB_KEY"
- finish pagkatapos mong gamitin ang code. Tinatanggap lang ito pagkatapos dumating ng code.
- cancel habang hinihintay pa ang unang code. Nire-refund ang buong presyo.
- Kung wala kang gagawin, mag-e-expire ang numerong walang code sa oras na nasa
expires_atat awtomatikong mare-refund. Nakadepende ang tagal sa serbisyo at bansa, kaya laging basahin angexpires_atsa halip na mag-assume ng nakapirming oras.
Mga halaga ng status
| Status | Ibig sabihin |
|---|---|
WAITING_SMS |
Nabili, naghihintay ng unang mensahe |
CODE_RECEIVED |
May dumating nang kahit isang mensahe |
COMPLETED |
Tinapos mo, o naubos ang oras pagkatapos ng code |
CANCELLED |
Kinansela bago ang anumang code, na-refund |
EXPIRED |
Walang code bago ang expires_at, na-refund |
Mga error
Pareho ang anyo ng bawat error. Kumilos batay sa code at reason, at huwag pansinin ang mga dahilang hindi mo pa kilala:
{ "code": "NO_NUMBERS_AVAILABLE", "message": "No numbers available for this service and country", "reason": "OUT_OF_STOCK" }
Ang mga karaniwang kaso ay 402 INSUFFICIENT_BALANCE, 409 NO_NUMBERS_AVAILABLE, 409 PRICE_CHANGED, 422 na may ACTIVATION_LIMIT_REACHED (hanggang 100 numero ang puwedeng maghintay nang sabay kada account), at 429 RATE_LIMITED na may header na Retry-After.
Nasa dokumentasyon para sa developer ang buong reference.
Nakatulong ba ang artikulong ito?
Salamat! Masaya kaming nakatulong.