SmsGrab

Tema

Mag-sign in Filipino

Pumili ng wika

Developer API

SMS verification direkta mula sa code mo

Isang HTTPS na tawag ang nagbibigay sa bot o platform mo ng totoong numero para sa WhatsApp, Telegram at marami pang serbisyo. Tanggapin ang code sa webhook o long polling at magbayad lang para sa mga numerong nakatanggap ng code.

Kumuha ng API key Basahin ang dokumentasyon
  • 1,321serbisyo
  • 145bansa
  • $0.10pinakamababang presyo bawat numero
  • Awtomatikorefund kapag walang code

curl

curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
  -H "Authorization: Bearer $SMSGRAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"indonesia"}'

Python

activation = requests.post(
    "https://smsgrab.com/api/dev/v1/activations",
    headers={"Authorization": f"Bearer {key}"},
    json={"service": "whatsapp", "country": "indonesia"},
).json()

Node.js

const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
  method: 'POST',
  headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());

PHP

$activation = json_decode((string) $client->post('activations', [
    'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
])->getBody(), true);

Go

order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation)
201 Created 
{
  "id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
  "compat_id": 100000123,
  "status": "WAITING_SMS",
  "service_id": "whatsapp",
  "country_id": "indonesia",
  "phone_number": "+6281234567890",
  "price_minor": 18,
  "currency": "USD",
  "expires_at": "2026-09-27T10:25:00.000Z",
  "sms": []
}

Ginawa para sa automation

Lahat ng kailangan ng integration mo, sa parehong imbentaryo ng numero, accounting at refund ng app.

  • Simpleng REST API

    Nahuhulaang JSON, idempotent na pagbili at malinaw na dahilan ng error na maaari mong aksyunan.

  • Pinirmahang webhook

    Mga event na may HMAC na pirma para sa bawat code at pagbabago ng status, na may muling pagsubok nang 24 na oras.

  • Long polling

    Hawakan ang request nang hanggang 30 segundo at makuha ang code sa sandaling dumating.

  • Tugma sa sms-activate

    Ituro ang iyong mga tool sa aming endpoint. Pareho pa rin ang mga aksyon at tugon.

  • Mga key na hawak mo

    Mga key na basa lang o pambili, IP allowlist, pang-araw-araw na limitasyon, expiry at rotation nang walang downtime.

  • Awtomatikong refund

    Walang code bago mag-expire ang numero? Agad na bumabalik ang pera sa balanse mo.

  • Paggamit at log ng request

    Pang-araw-araw na request, gastos at error bawat key, dagdag ang nafi-filter na log ng nakaraang 7 araw.

  • Presyong ayon sa volume

    Presyong batay sa wholesale na kusang bumababa habang lumalaki ang buwanang volume mo.

Magsimula sa apat na hakbang

Ilang tawag lang bago ang unang numero.

  1. Gumawa ng account

    Mag-sign up gamit ang email at i-verify ito. Iisang account ang ginagamit ng app at website.

  2. Gumawa ng API key

    Piliin ang access, limitahan ang key sa iyong mga server at kopyahin ang secret nang isang beses.

  3. Bumili ng numero

    I-POST ang serbisyo at bansa. Agad na bumabalik ang numero at presyo.

  4. Tanggapin ang code

    Hintayin ito sa long polling o webhook, pagkatapos ay tapusin ang activation.

Buksan ang quickstart

Presyong bumababa habang lumalaki ka

Nagsisimula ang presyo ng developer sa wholesale na gastos ng bawat numero dagdag ang markup na lumiliit ayon sa 30-araw na volume mo.

  • Hindi kailanman mas mahal kaysa sa parehong numero sa app
  • Hindi bababa sa $0.10 bawat numero
  • Awtomatikong nire-refund ang mga numerong walang code
  • Naa-update ang tier ilang minuto matapos maabot
  • Sinisingil sa USD mula sa parehong balanse ng app

Markup ayon sa 30-araw na gastos ng developer

Gastos ng developer sa 30 araw Markup sa wholesale Halimbawang presyo
Hanggang $100.00 +80% $0.18 28% mas mura kaysa sa app
Mula $100.00 +70% $0.17 32% mas mura kaysa sa app
Mula $500.00 +60% $0.16 36% mas mura kaysa sa app
Mula $2,000.00 +50% $0.15 40% mas mura kaysa sa app

Halimbawa: isang alok na may wholesale na gastos na $0.10 na nagkakahalaga ng $0.25 sa app.

Kumuha ng API key

Paglipat

Lumipat mula sa sms-activate sa isang linya

Pareho ang protocol ng aming tugmang endpoint, kaya gagana ang mga bot at panel para sa sms-activate sa sandaling palitan mo ang base URL at key.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices at iba pang karaniwang aksyon
  • Numerikong activation ID, service code at country ID na ginagamit mo na
  • Parehong mga key, limitasyon, presyo, refund at webhook gaya ng REST API
Sanggunian sa compatibility

curl

BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"

curl -s "$BASE&action=getBalance"
curl -s "$BASE&action=getNumber&service=tg&country=6"
curl -s "$BASE&action=getStatus&id=100000123"
curl -s "$BASE&action=setStatus&id=100000123&status=6"

Python

import os

import requests

BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]


def action(name: str, **params) -> str:
    response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
    response.raise_for_status()
    return response.text


print(action("getBalance"))
answer = action("getNumber", service="tg", country=6)
if answer.startswith("ACCESS_NUMBER:"):
    _, activation_id, number = answer.split(":")
    print(activation_id, number)

Real time

Diretso sa server mo ang mga code

Mag-subscribe sa mga event na kailangan mo at ihahatid namin ang mga ito sa iyong HTTPS endpoint na may pirmang maaaring i-verify.

  • Nabili ang numero
  • Natanggap ang code
  • Tapos ang activation
  • Kinansela ang activation
  • Nag-expire ang activation
  • Na-refund
  • Mababa ang balanse
Gabay sa webhook
600request kada minuto bawat key
60pagbili kada minuto bawat key
100sabay-sabay na naghihintay na numero
30segundo ng long polling
  • Bawat delivery ay pinirmahan ng HMAC-SHA256 na may timestamp
  • Pampublikong HTTPS endpoint lang, sinusuri bago ang bawat delivery
  • Test delivery, 30 araw na history at muling pagpapadala sa isang click

Mga tanong ng developer

Magkano ang developer API?

Walang subscription. Ang bawat numero ay wholesale na presyo dagdag ang 80% markup, na bumababa sa 70%, 60% at 50% kapag lumampas ang 30-araw na gastos mo sa 100, 500 at 2000 USD. Walang numerong mas mababa sa 0.10 USD o mas mahal kaysa sa app.

Paano kung hindi dumating ang code?

Aktibo ang numero nang 20 minuto. Kung walang code sa panahong iyon, o kinansela mo ang numero habang naghihintay pa, awtomatikong babalik ang pera sa balanse mo.

Magagamit ko ba ang integration ko sa sms-activate?

Oo. Palitan ang base URL sa aming tugmang endpoint at gamitin ang SmsGrab key. Pareho pa rin ang mga karaniwang aksyon, tugon at numerikong ID.

Ano ang mga rate limit?

Bilang default, ang bawat key ay makakagawa ng 600 request at 60 pagbili kada minuto, lahat ng key ng account ay 3000 request kada minuto nang magkakasama, at hanggang 100 numero ang maaaring sabay-sabay na maghintay ng code.

Paano ko poprotektahan ang key ko?

Itago lang ang mga key sa server, bigyan ang bawat app ng sariling key, limitahan ito sa address ng server at magtakda ng pang-araw-araw na limitasyon. Kung posibleng na-leak ang key, i-rotate o bawiin ito mula sa account mo.

Iisa ba ang balanse ng app at API?

Oo. Ginagamit ng API ang balanse ng SmsGrab account mo, at lumalabas sa wallet mo ang bawat pagbili at refund gaya ng iba.

Mas maraming sagot sa help center

Handa nang i-automate ang verification?

Gumawa ng key sa account mo at gawin ang unang tawag sa loob ng ilang minuto.

Kumuha ng API key Basahin ang dokumentasyon