Het sms-activate-compatibele endpoint

Veel tools spreken het sms-activate-protocol. SmsGrab biedt een compatibel endpoint, dus deze tools werken zodra je de basis-URL wijzigt en je SmsGrab-API-sleutel gebruikt.

Endpoint

https://smsgrab.com/api/stubs/handler_api.php

Stuur api_key en action plus de parameters van de actie, via GET of POST. De sleutel kan ook als Authorization: Bearer worden gestuurd.

Voorbeeld

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"

ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

Ondersteunde acties

Id's

• Diensten gebruiken de korte codes van het protocol waar die bestaan, zoals wa WhatsApp, tg Telegram, go Google, fb Facebook, ig Instagram en ds Discord. Onze eigen dienst-id's werken ook.
• Landen gebruiken de numerieke id's van het protocol waar die bestaan, zoals 0 Rusland, 6 Indonesië, 4 Filipijnen, 22 India en 187 VS. Onze id's en ISO-codes werken ook.
• getCountries en getServicesList geven de volledige, actuele lijsten.
• Een id van een activering is een getal zoals 100000123, en de REST-API accepteert het ook.

Verschillen die je moet kennen

• Bedragen zijn in Amerikaanse dollars met twee decimalen, tegen je ontwikkelaarsprijs. Het zijn geen roebels.
• operator wordt genegeerd; het beste beschikbare aanbod wordt voor je gekozen.
• Fouten worden beantwoord zoals in het oorspronkelijke protocol, met HTTP 200 en een tekst zoals NO_NUMBERS, NO_BALANCE of BAD_KEY. Te veel verzoeken krijgen HTTP 429 met TOO_MANY_REQUESTS.
• NO_ACCESS betekent dat de sleutel de scope purchase mist, dat het IP-adres niet is toegestaan of dat de dagelijkse uitgavelimiet is bereikt.
• Huurnummers zijn niet beschikbaar via dit endpoint.

Al het andere deel je met de REST-API: dezelfde sleutels, limieten, prijzen, terugbetalingen en webhooks.