Pumili ng wika

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
  1. Sino ang puwedeng gumamit nito
  2. 1. Gumawa ng API key
  3. 2. Authentication
  4. 3. Tingnan ang balanse at mga presyo
  5. 4. Bumili ng numero
  6. 5. Hintayin ang SMS
  7. 6. Tapusin o kanselahin
  8. Mga halaga ng status
  9. Mga error

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:

HTTP
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

Bash
export SMSGRAB_KEY="sgk_your_key_here"

curl -s https://smsgrab.com/api/dev/v1/balance \
  -H "Authorization: Bearer $SMSGRAB_KEY"
Bash
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.

JSON
{ "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

Bash
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 service at country ng mga id namin, gaya ng whatsapp at indonesia. Tumatanggap din ang country ng ISO code gaya ng ID.
  • Pinoprotektahan ka ng max_price_minor: kung tumaas ang presyo, walang ibabawas at makakakuha ka ng 409 PRICE_CHANGED.
  • Ginagawang ligtas ng Idempotency-Key ang 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:

JSON
{ "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:

Bash
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:

JSON
{ "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

Bash
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_at at awtomatikong mare-refund. Nakadepende ang tagal sa serbisyo at bansa, kaya laging basahin ang expires_at sa 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:

JSON
{ "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?

Kailangan mo pa ng tulong?

Sumulat sa amin. Sinasagot namin ang bawat mensahe, karaniwan sa loob ng ilang oras.

O mag-email sa support@smsgrab.com