Dokumentace API
Čísla, zprávy a výnosy přímo z vaší aplikace.
Začněte jedním požadavkem
Vytvořte klíč API ve vaší tabulce, získejte číslo a kontrolujte zprávy každých 20 sekund. Platba je kreditována, když SMS s kódem přijde; čtení znovu neovlivňuje vaši rovnováhu.
https://smscash.org/api/v1https://smscash.org/stubs/handler_api.phpcurl -X POST 'https://smscash.org/api/v1/activations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: request-unique-001' \
-d '{"service":"go","country":86}'Alternativní kompatibilní rozhraní adresa: /handler_api.php. Stávající integrace REST pokračují v práci.
Tvůrce požadavků
Idempotency-Key: UUID · POST · 8–128
Automatický výběr: nejvíce kódů za poslední hodinu, pak za 24 hodin. Bez čísel: další operátor.
curl --max-time 15 --fail-with-body -X POST 'https://smscash.org/api/v1/activations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: request-unique-001' \
--data '{"service":"go","country":86}'package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
"time"
)
func main() {
payload := []byte("{\"service\":\"go\",\"country\":86}")
req, err := http.NewRequest("POST", "https://smscash.org/api/v1/activations", bytes.NewReader(payload))
if err != nil { panic(err) }
req.Header.Set("Authorization", "Bearer " + os.Getenv("SMSCASH_API_KEY"))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", "request-unique-001")
client := &http.Client{Timeout: 15 * time.Second, CheckRedirect: func(_ *http.Request, _ []*http.Request) error { return http.ErrUseLastResponse }}
res, err := client.Do(req)
if err != nil { panic(err) } // Keep the same operation key after a network error.
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil { panic(err) }
if res.StatusCode >= 300 {
fmt.Fprintf(os.Stderr, "HTTP %d, request_id=%s\n%s\n", res.StatusCode, res.Header.Get("X-Request-ID"), body)
os.Exit(1)
}
fmt.Println(string(body))
}// Node.js 18+: set SMSCASH_API_KEY in your environment.
const response = await fetch("https://smscash.org/api/v1/activations", {
method: "POST",
headers: {
Authorization: 'Bearer ' + process.env.SMSCASH_API_KEY,
'Content-Type': 'application/json',
'Idempotency-Key': "request-unique-001",
},
body: JSON.stringify({
"service": "go",
"country": 86
}),
signal: AbortSignal.timeout(15000),
redirect: 'error',
});
const result = await response.json();
if (!response.ok) {
const error = result.error || {};
console.error(response.status, error.code, error.hint, error.request_id);
throw new Error(error.message || 'API error');
}
console.log(result);
// SMS codes are strings: keep leading zeros. Never retry writes automatically.import json
import os
import urllib.error
import urllib.request
class NoRedirect(urllib.request.HTTPRedirectHandler):
def redirect_request(self, req, fp, code, msg, headers, newurl):
return None
headers = {
'Authorization': 'Bearer ' + os.environ['SMSCASH_API_KEY'],
'Content-Type': 'application/json',
'Idempotency-Key': "request-unique-001",
}
request = urllib.request.Request(
"https://smscash.org/api/v1/activations",
headers=headers,
data="{\"service\":\"go\",\"country\":86}".encode('utf-8'),
method="POST",
)
try:
with urllib.request.build_opener(NoRedirect).open(request, timeout=15) as response:
result = json.load(response)
print(result)
except urllib.error.HTTPError as error:
details = json.load(error).get('error', {})
print(error.code, details.get('code'), details.get('hint'), details.get('request_id'))
raise
# No automatic retries; SMS codes remain strings.Klíč se neukládá. Toto ověření nepřiděluje čísla.
Zbývají nové integrace
Služby a země
Vyberte si službu a zemi. platba SMS závisí na zemi.
GET /api/v1/catalog?service=go&country=86&page=1&page_size=100
Authorization: Bearer YOUR_API_KEY{
"rows": [
{
"offer_id": 42,
"service": "go",
"service_name": "Google",
"country_id": 86,
"country_name": "Italy",
"provider_id": 1,
"operator": 1,
"provider_name": "Operator 1",
"reward": "0.00300000",
"currency": "USD",
"accounting_precision": 8,
"earnings_hold_days": 45
}
],
"page": 1,
"page_size": 100,
"total": 1,
"pages": 1,
"has_more": false,
"accounting_precision": 8
}service · country · operator · q · page · page_size (1–100)
Získejte číslo
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001
{
"service": "go",
"country": 86
}Automatický výběr: nejvíce kódů za poslední hodinu, pak za 24 hodin. Bez čísel: další operátor.
201: new session · 200: replay of the same operation
service + country OR offer_id · duration_minutes: 20
ref: software owner code (optional)
operator: public ID (e.g. 1 for Operator 1), optional · any/0: automatic
country: integer · service: string · SMS code: stringČíslo je platné po dobu 20 minut. SMS je kontrolován každých 20 sekund. můžete okamžitě zrušit.
Ověřit více čísel
GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY{
"rows": [
{
"id": 42,
"found": true,
"phone": "12025550123",
"status": "received",
"service": "go",
"country_id": 86,
"provider_id": 1,
"operator": 1,
"expires_at": "2026-10-10T12:15:00Z",
"sms_count": 1,
"code": "001234",
"last_sms": {
"id": 101,
"code": "001234",
"sender": "Service",
"text": "Code: 001234",
"received_at": "2026-10-10T12:01:00Z"
}
},
{
"id": 43,
"found": false,
"error": {
"code": "NO_ACTIVATION",
"message": "Session not found."
}
}
],
"as_of": "2026-10-10T12:01:00Z",
"poll_interval_seconds": 20
}ids: 1–100 positive session IDs, separated by commas
Input order preserved · duplicates removed
Foreign, unavailable or out-of-scope IDs: found=false
Read only · no supplier requests · last_sms is the latest messageZůstatek · Pozastaveno
GET /api/v1/balance
Authorization: Bearer YOUR_API_KEY{
"currency": "USD",
"accounting_precision": 8,
"balance": "12.00000000",
"held_balance": "34.50000001",
"balance_minor": "1200000000",
"held_minor": "3450000001",
"as_of": "2026-10-12T20:00:00Z",
"next_release_at": "2026-11-26T20:00:00Z"
}balance — Dostupné; held_balance — Pozastaveno. USD · 8
Vybrat lze pouze prostředky, u kterých skončila čekací doba.
Klienti připravení k použití
import {SmScash, SmScashError} from './smscash.mjs';
import {randomUUID} from 'node:crypto';
const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);
// Save this key before sending; keep it for retries of this operation.
const requestKey = randomUUID();
const session = await api.createNumber({service: 'go', country: 86}, requestKey);
// After 20 seconds:
const messages = await api.sms(session.id, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([session.id]);
const held = await api.holdBalance();
console.log(held); // Exact USD stringimport os
import uuid
from smscash import SmScash, SmScashError
api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])
# Save this key before sending; keep it for retries of this operation.
request_key = str(uuid.uuid4())
session = api.create_number({'service': 'go', 'country': 86}, request_key)
# After 20 seconds:
messages = api.sms(session['id'], after_id=0)
print(messages['sms'])
statuses = api.batch([session['id']])
held = api.hold_balance()
print(held) # Exact USD stringme() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
createNumber(parameters, requestKey) / create_number(parameters, request_key)
setStatus(id, "cancel") / set_status(id, "cancel")
setStatus(id, "retry", requestKey) / set_status(id, "retry", request_key)
Timeout: 15 s · no dependencies · no automatic retries
Error: code · status · hint · requestId/request_id · retryable
ALLOCATION_UNCERTAIN: contact support with request_id; never retry automatically.SMS-Activate / HeroSMS
https://smscash.org/sms-activate/stubs/handler_api.phphttps://smscash.org/hero-sms/stubs/handler_api.phpOsobní API klíč uživatele.
Vyberte si službu a zemi. platba SMS závisí na zemi.
| Kód | Popis |
|---|---|
getNumber / getNumberV2 | Získejte číslo |
getStatus / getStatusV2 | Získejte nejnovější kód |
setStatus / finishActivation / cancelActivation | Řízení sezení |
getPrices / getNumbersStatus | Zkontrolujte dostupnost |
getRewards (SMScash) | Odměna za SMS |
getServicesList / getServices | Služby |
getCountries / getOperators | Služby a země |
getActiveActivations | Sezóny |
getBalance | Zůstatek uživatele |
getHoldBalance (SMScash) | Pozastaveno |
cost = 0 USD · activationCost = 0 USDreward — Odměna za SMS
curl --get 'https://smscash.org/hero-sms/stubs/handler_api.php' \
--data-urlencode 'api_key=YOUR_API_KEY' \
--data-urlencode 'action=getNumberV2' \
--data-urlencode 'service=go' \
--data-urlencode 'country=86' \
-H 'Idempotency-Key: request-unique-001'{
"activationId": "42",
"phoneNumber": "393331234567",
"activationCost": 0,
"currency": 840,
"countryCode": 86,
"canGetAnotherSms": true,
"activationTime": "2026-10-11T12:00:00Z",
"activationEndTime": "2026-10-11T12:15:00Z",
"reward": "0.00300000"
}GET or POST application/x-www-form-urlencoded
api_key · action · service · country · ref (optional)
setStatus: 1 → ACCESS_READY · 3 → ACCESS_RETRY_GET
6 → ACCESS_ACTIVATION · 8 → ACCESS_CANCEL
getStatus: STATUS_WAIT_CODE · STATUS_OK:001234 · STATUS_CANCEL
getStatusV2: {"verificationType":1,"sms":null,"call":null}
getServicesList: {"status":"success","services":[{"code":"go","name":"Google"}]}
getCountries: {"86":{"id":86,"eng":"Italy","visible":1,"retry":1,"rent":0}}
getPrices: {"86":{"go":{"cost":0,"count":12,"reward":"0.00300000","currency":"USD"}}}
getRewards: {"59":{"vi":{"1":"0.01000000"}}}
getRewards filters: country · service · operator (optional); any/0: all permitted providers
getActiveActivations: start=0 · limit=1–100 · activeActivations / data
Business/key errors: HTTP 200 + plain text · server errors: HTTP 500
Availability: actual supplier pool, shared cache up to 20 s; not a reservation
No automatic retries after a transport error or ALLOCATION_UNCERTAIN.
Keep the original Idempotency-Key and parameters.
Unsupported: rent · calls · forwarding · multiple services per number · prolong
Unsupported options return BAD_REQUEST; unsupported actions return BAD_ACTION.
SMScash keys and country/service codes; configure this base URL in your software.Číslo je platné po dobu 20 minut. SMS je kontrolován každých 20 sekund. můžete okamžitě zrušit.
Autentikace a odchody
REST: Hledá Authorization: Bearer YOUR_API_KEY. kompatibilní rozhraní: parametry api_key a actionPoužijte HTTPS
Chcete-li spravovat klíče API, zadejte svůj účet.
Častota požadavků API a počet telefonních čísel jsou neomezené.Neexistují denní nebo hodinové kvóty.
Číslo je platné po dobu 20 minut. SMS je kontrolován každých 20 sekund. můžete okamžitě zrušit.
Zbytek, jedinečný Idempotency-Key je nutné pro přidělování čísel, opakování přidělování, odvolání a požadavky na platbu. je volitelné, ale doporučeno v handler_api.php. při odvolání požadavku na síť znovu použijte klíč; použijte nový klíč pro novou operaci.
Klíčový rozsah API
Můžete omezit klíč na konkrétní služby, země a poskytovatele. prázdné seznamy umožňují všechny dostupné možnosti.
{
"label": "Můj software",
"policy": {
"services": [
"go"
],
"countries": [
86
],
"providers": [
1
]
}
}PATCH /api/v1/keys/{id} Změna názvu a politiky zcela. Tajemství je zřejmé pouze tehdy, když je vytvořeno.
10% v celkové. 5% + 5% s softwarovým kódem.
Při vydávání čísla, prosím, poskytněte ref majitel softwaru. žádost je pověřena klíčem prováděcího. kód je v sekci "Referrals" a v GET /api/v1/referrals → software_ref.
| Žádost | Pozvánka | Software |
|---|---|---|
| Bez ref | 10% | — |
| s ref | 5% | 5% |
| S ref, bez referera | — | 5% |
Platba platby platby bez snížení výnosů uživatele. majitel softwaru a referer může být stejná osoba.
Termíny jsou stanoveny, když je vytvořena schůze; čtení SMS a odchod se nemění. Přejít ref znovu pro novou opakovanou schůzi. V výpočtu poplatků, odměna uživatele USD 0.003 dává USD 0.00015 každý majiteli softwaru a referera. Celkový bonus je USD 0.00030.
Řízení API
11 XVBC-tylu metody plus váš SMScash rovnováha.
GETgetNumberZískejte číslo+
Vytváří se zasedání a rezervuje k dispozici číslo pro uživatele. sazba odměny a referenční příjemci jsou fixovány na přidělení; odměna je kreditována, když SMS s kódem přijde.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
service* | string | K dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API. |
country* | integer | Vzít ID od getCountries. |
operator | string | Vzít ID od operators/getOperators (API). operator=1 · any/0 |
session_duration | integer | Sezóna trvá 20 minut. projděte 20 nebo omezte tento parametr. |
with_operator | integer | 1 přidá do odpovědi ID operátora; 0 nebo vynechaný parametr vrátí tři části. |
ref | string | Veřejný kód majitele softwaru: 5% pro něj a 5% pro hostitele. bez ref - 10% pro hostitele. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getNumber.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1' \
-H 'Idempotency-Key: request-unique-001'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1", nil)
if err != nil { panic(err) }
req.Header.Set("Idempotency-Key", "request-unique-001")
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1", {
headers: {"Idempotency-Key": "request-unique-001"}
});
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1",
headers={"Idempotency-Key": "request-unique-001"},
timeout=15,
)
print(response.status_code, response.text)Odpovědi
ACCESS_NUMBER:42:380670000000:1EMPTY_POOL- Automatický výběr: nejvíce kódů za poslední hodinu, pak za 24 hodin. Bez čísel: další operátor.
- Prochází Idempotency-Key: stejné žádosti s stejným klíčem vrátí předchozí sesce. Změní parametrů zavolání IDEMPOTENCY_CONFLICT.
- Číselná země bez bazénu poskytuje EMPTY_POOL; chybný formát země je BAD_COUNTRY.
- Klíč k odstraněné sezení zůstává použit: přehrávání přidělení s tímto klíčem vrátí SESSION_CLOSED a nevydává další číslo.
- Výsledek přidělení není potvrzen. automatické odstupování je znemožněno, aby se zabránilo přidělování druhého čísla.
GETgetNumbersStatusZkontrolujte dostupnost+
Telefonní čísla jsou k dispozici podle služby a země.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
country* | integer | Vzít ID od getCountries. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getNumbersStatus.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86");
const result = await response.json();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86",
timeout=15,
)
print(response.status_code, response.json())Odpovědi
{
"go_0": 0
}- _0 suffix znamená volbu bez konkrétního operátora.
- Dostupnost se vztahuje na celkový bazén dodavatele.Vybraný kanál se kontroluje, když je přidělen číslo.
GETgetStatusZískejte nejnovější kód+
Jednoduchá žádost o status sezení a poslední SMS kód. Vedoucí zeros v kódu jsou zachovány.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
id* | integer | ID vašeho zasedání, které bylo obdržené po vydání čísla. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getStatus.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42");
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42",
timeout=15,
)
print(response.status_code, response.text)Odpovědi
STATUS_WAIT_CODESTATUS_OK:001234STATUS_CANCELNO_ACTIVATION- Poll každých 20 sekund. čtení zprávy znovu neznamená další platbu.
- Poté retry starý kód není zpět: getStatus počkat na další SMS.
- Po čísle bez SMS je vymazán, getStatus a getSms Návrat STATUS_CANCEL; getSmsFull vrátí zavřený stav, prázdný telefon a prázdný sms a seznam . REST /activations/{id} a /sms Návrat 404 NO_ACTIVATION.
GETsetStatusŘízení sezení+
Končí, zruší nebo znovu čeká na SMS.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
id* | integer | ID vašeho zasedání, které bylo obdržené po vydání čísla. |
status* | integer | 3 – čekat na další kód bez prodloužení sezení; 6 – dokončit po SMS; 8 – okamžitě zrušit. |
* Požadovaný parametr. ve všech požadavcích také projít akce =setStatus.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3' \
-H 'Idempotency-Key: request-unique-001'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3", nil)
if err != nil { panic(err) }
req.Header.Set("Idempotency-Key", "request-unique-001")
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3", {
headers: {"Idempotency-Key": "request-unique-001"}
});
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3",
headers={"Idempotency-Key": "request-unique-001"},
timeout=15,
)
print(response.status_code, response.text)Odpovědi
ACCESS_RETRY_GETACCESS_ACTIVATIONACCESS_CANCEL- Odstoupí čeká na další kód do původních 20 minut. Výstup a časy uplynutí se nezmění.
- pro status =3 Použití Idempotency-Key: opakování žádosti nebude znovu nastaven nový kód již obdržený. SMS Zůstává k dispozici.
- Zrušení nezruší odměny, které již získal.
- V historii jsou uchovávány pouze čísla s kódem SMS. Odstraněné a vypršené čísla bez kódu jsou odstraněny.
GETgetRepeatNumberZnovu si vytáhněte stejné číslo+
Otevřete novou schůzku s konkrétním číslem z vašeho historie.Můžete si vybrat jinou dostupnou službu ve stejné zemi.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
number* | string | Vaše staré číslo. pouze čísla a volitelný vedoucí + jsou povoleny. |
service* | string | K dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API. |
session_duration | integer | Sezóna trvá 20 minut. projděte 20 nebo omezte tento parametr. |
with_operator | integer | 1 přidá do odpovědi ID operátora; 0 nebo vynechaný parametr vrátí tři části. |
ref | string | Veřejný kód majitele softwaru: 5% pro něj a 5% pro hostitele. bez ref - 10% pro hostitele. |
operator | string | Vzít ID od operators/getOperators (API). operator=1 · any/0 |
* Požadovaný parametr. ve všech požadavcích také projít akce =getRepeatNumber.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go' \
-H 'Idempotency-Key: request-unique-001'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go", nil)
if err != nil { panic(err) }
req.Header.Set("Idempotency-Key", "request-unique-001")
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go", {
headers: {"Idempotency-Key": "request-unique-001"}
});
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go",
headers={"Idempotency-Key": "request-unique-001"},
timeout=15,
)
print(response.status_code, response.text)Odpovědi
ACCESS_NUMBER:43:380670000000NUMBER_IN_USE- Nejprve ukončte nebo zrušte aktuální sezení. Pokud je číslo zaneprázdněné, re-exuance se neprovádí.
- Nová sezení dostane nový ID a aktuální sazbu. staré SMS nejsou kopírovány do něj. ref je znovu nastaven.
- SMScash umožňuje opakovat pouze čísla z historie tohoto účtu.
- Klíč k odstraněné sezení zůstává použit: přehrávání přidělení s tímto klíčem vrátí SESSION_CLOSED a nevydává další číslo.
GETgetSmsFullSMS jako JSON+
Struktura historie všech zpráv s ID, odesílatel, kód, text a země, služba a data dodavatele.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
id* | integer | ID vašeho zasedání, které bylo obdržené po vydání čísla. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getSmsFull.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42");
const result = await response.json();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42",
timeout=15,
)
print(response.status_code, response.json())Odpovědi
{
"success": true,
"session_id": 42,
"phone": "380670000000",
"status": 1,
"status_name": "received",
"sms_count": 1,
"sms": [
{
"id": 101,
"external_id": "message-101",
"sender": "Service",
"code": "001234",
"text": "Код подтверждения: 001234",
"received_at": "2026-10-09T12:00:00Z",
"country": {
"id": 86,
"name": "Italy"
},
"service": {
"code": "go",
"name": "Google"
},
"provider": {
"id": 1,
"name": "Оператор 1"
}
}
],
"expires_at": "2026-10-09T12:20:00Z"
}- Vymyslete si SMS[].id pro zpracování pouze nových zpráv.
- Číselný status SMScash: 1 - aktivní, 6 - dokončený, 8 - zrušený nebo uplynul. status_name rozlišuje mezi čekáním, přijatím, dokončením, zrušením, uplynutím.
- Odchylované kódy zůstanou k dispozici po zavření sesniny. Pro velké objemné použití REST /activations/{id}/sms s after_id.
- Po čísle bez SMS je vymazán, getStatus a getSms Návrat STATUS_CANCEL; getSmsFull vrátí zavřený stav, prázdný telefon a prázdný sms a seznam . REST /activations/{id} a /sms Návrat 404 NO_ACTIVATION.
GETgetSmsSMS jako textový řetězec+
Vrací celý historický text SMS ve formátu řetězce pro stávající klienty.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
id* | integer | ID vašeho zasedání, které bylo obdržené po vydání čísla. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getSms.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42");
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42",
timeout=15,
)
print(response.status_code, response.text)Odpovědi
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234STATUS_WAIT_CODESTATUS_CANCEL- Formát zprávy: časový kód, text. Mnoho zpráv je odděleno kolónem.
- Textové SMS může obsahovat kolony a vertikální pruhy. pro spolehlivé parsing použijte getSmsFull.
GETgetServicesSlužby+
K dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
country | integer | Vzít ID od getCountries. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getServices.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY",
timeout=15,
)
print(response.status_code, response.json())Odpovědi
{
"go": {
"name": "Google",
"code": "go"
}
}- Služební adresář je sdílen mezi dodavatelem. dostupnost čísla je ověřena samostatně.
GETgetCountriesZemě+
ID, jména a volací kódy pro země v vybraném kanálu.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getCountries.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY",
timeout=15,
)
print(response.status_code, response.json())Odpovědi
{
"86": {
"id": 86,
"name": "Italy",
"phone_code": "39"
}
}GETgetOperatorsOperátory+
Dostupní operátoři: API ID, název a doba zadržení odměny.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
country | integer | Vzít ID od getCountries. |
operator | string | Vzít ID od operators/getOperators (API). operator=1 · any/0 |
* Požadovaný parametr. ve všech požadavcích také projít akce =getOperators.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY",
timeout=15,
)
print(response.status_code, response.json())Odpovědi
{
"1": {
"id": 1,
"provider_id": 1,
"operator": 1,
"name": "Оператор 1",
"earnings_hold_days": 45
}
}- Vzít ID od operators/getOperators (API).
GETgetRewardsOdměna za SMS+
Cena závisí na zemi. Všechny tabulkové částky jsou za placené SMS.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
country | integer | Vzít ID od getCountries. |
service | string | K dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API. |
operator | string | Vzít ID od operators/getOperators (API). operator=1 · any/0 |
* Požadovaný parametr. ve všech požadavcích také projít akce =getRewards.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi");
const result = await response.json();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi",
timeout=15,
)
print(response.status_code, response.json())Odpovědi
{
"59": {
"vi": {
"1": "0.01000000",
"3": "0.00500000"
}
}
}{}- USD tarifní částky jsou vráceny jako přesné desáté řetězce s 8 desátými místy:
- Nabídky jsou k dispozici pro váš klíč.
- country ID → service code → operator ID → reward (USD)
GETgetBalanceZůstatek uživatele+
SMScash: dostupná rovnováha s ohledem na akruály, referenční bonusy a požadavky na platbu.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getBalance.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY");
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY",
timeout=15,
)
print(response.status_code, response.text)Odpovědi
ACCESS_BALANCE:0.00- getBalance vrací dostupnou rovnováhu USD s až 8 desetinovými místy.
- Vybrat lze pouze prostředky, u kterých skončila čekací doba.
GETgetHoldBalancePozastaveno+
Po přijetí SMS jsou výdělky pozastaveny na dobu stanovenou dodavatelem. V uvedený den se částka automaticky zpřístupní k výběru.
Parametry
| Parametry | Typ | Popis |
|---|---|---|
api_key* | string | Osobní API klíč uživatele. |
* Požadovaný parametr. ve všech požadavcích také projít akce =getHoldBalance.
Příklad žádosti
curl 'https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY'package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY", nil)
if err != nil { panic(err) }
client := &http.Client{Timeout: 15 * time.Second}
resp, err := client.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil { panic(err) }
fmt.Println(resp.StatusCode, string(body))
}const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY");
const result = await response.text();
console.log(response.status, result);import requests
response = requests.get(
"https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY",
timeout=15,
)
print(response.status_code, response.text)Odpovědi
ACCESS_HOLD_BALANCE:34.50000001- SMScash · getHoldBalance · USD · 8
- Vybrat lze pouze prostředky, u kterých skončila čekací doba.
Kód odpovědi a opakování žádostí
Vevnitř handler_api.php obchodní výsledky obvykle přijde s HTTP 200. Zkontrolujte tělový tekst. Zdroje a getSmsFull zpět JSON pokud je úspěšný; chyby jsou vždycky text.
| Kód | HTTP | Příčina a další krok |
|---|---|---|
TARIFF_NOT_CONFIGURED | 200 | Ceny zatím neprovedlyPořadí počítá, jakmile bude SMS odměna nastavená. |
COUNTRY_BLOCKED | 200 | Číslo přidělení pro tuto zemi je blokováno.Vyberte si jinou zemi. |
BAD_SERVICE | 200 | Číslo přidělení pro tuto službu je blokováno.Vyberte si jinou službu. |
PROVIDER_NOT_READY | 200 | Číslo přidělení je dočasně nedostupnéVydejte se do katalogů API. |
BAD_KEY | 400 | Ne api_key nebo nevažný formát.Zkontrolujte klíč v žádosti. |
INVALID_API_KEY | 401 | Klíč je neznámý, zrušený nebo účet je zrušen.Vytvořte si platný API klíč. |
BAD_COUNTRY | 400 | Členské státy chybí nebo ne pozitivní číslo.Vzít ID od getCountries. |
BAD_SESSION_DURATION | 400 | Telefonní čísla jsou vydávány přesně po dobu 20 minut.Správně session_duration. |
BAD_REQUEST | 400 | Nepodležný parameter nebo Idempotency-Key.Prosím, opravte prosím vaši žádost. |
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER | 200 | Neznámé nebo zrušené položky adresáře.Vydejte se do katalogů API. |
BAD_NUMBER | 200 | Nesprávný formát čísla.Vložte číslo v číslech. |
BAD_ACTION / BAD_STATUS | 200 | Neznámá příkaz, ID nebo operace.Podívejte se na nastavení. |
EMPTY_POOL | 200 | V současné době nejsou k dispozici žádné telefonní čísla.Opakujte po 10-30 Změna nebo změna filtru. |
NUMBER_IN_USE | 200 | Jedno konkrétní číslo je obsazeno aktivní secí.Zrušit svůj účet nebo vyberte další číslo. |
NO_ACTIVATION | 200 | Sezóna nebo předchozí číslo nepatří k vašemu účtu.Zkontrolujte ID a klíč. |
SESSION_CLOSED / SMS_REQUIRED | 200 | V současné době není státní přechod k dispozici.Zkontrolujte stav a dostupnost SMS zpráv. |
SCOPE_BLOCKED | 200 | Služba, země nebo dodavatel není oprávněn k klíči.Aktualizujte rozsah klíče API. |
IDEMPOTENCY_CONFLICT | 200 | Tento klíč dotazů je již spojen s dalšími parametry.Pro novou operaci vytvořte další Idempotency-Key. |
BAD_REF / SELF_REF | 400 | Kód softwaru je neznámý, zrušený nebo patří samotnému uživatelovi.Zadejte kód vlastníka softwaru. |
INTERNAL_ERROR | 500 | Způsoby chybějícího serveru nebo dodavatele.Znovu s odpovídajícím a stejném Idempotency-Key. |
ALLOCATION_PENDING | 200 | Vstup do práce je v plném rozsahu.Retry s stejným Idempotency-Key.Vstup do práce je v plném rozsahu.Retry s stejným Idempotency-Key. |
ALLOCATION_UNCERTAIN | 200 | Výsledek přidělení není potvrzen. automatické odstupování je znemožněno, aby se zabránilo přidělování druhého čísla.Výsledek přidělení není potvrzen. automatické odstupování je znemožněno, aby se zabránilo přidělování druhého čísla. |
Zbytek vrací předmět {"error":{"code":"…","message":"…"}} a pravidelné HTTP statuty 400/401/403/404/409/503.
{
"error": {
"code": "BAD_REQUEST",
"message": "Zkontrolujte požadavky na pole.",
"request_id": "req_…",
"hint": "Use the documented JSON type; numbers must not be quoted.",
"retryable": false,
"details": {
"field": "country",
"expected": "integer"
}
}
}X-Request-ID: included in every API response
405: Allow lists the supported HTTP methods
ALLOCATION_PENDING: retryable=true · Retry-After=3 · same operation key
ALLOCATION_UNCERTAIN: retryable=false · contact support
Transport errors: check the operation before another write; keep the original key.Zbývají nové integrace
USD tarifní částky jsou vráceny jako přesné desáté řetězce s 8 desátými místy: 0.00300000 USD.
Měna je USD. Schémata žádosti a odpovědi jsou k dispozici v OpenAPI.
/api/v1/catalogSlužby a země/api/v1/tariffsSMS odměny podle země/api/v1/offersCeny a odměny/api/v1/servicesředitelství/api/v1/countriesředitelství/api/v1/operatorsředitelství/api/v1/availability?country=1Dostupnost čísla/api/v1/activationsNová zasedání/api/v1/activations/batch?ids=42,43Ověřit více čísel/api/v1/activationsPosledních 200 setkání: scope = historie, čekání nebo vše/api/v1/activations/{id}Session a poselství/api/v1/activations/{id}/sms?after_id=0&limit=100SMS s novým kurzorem/api/v1/activations/{id}/retryČekání na SMS/api/v1/activations/{id}/finishKompletní/api/v1/activations/{id}/cancelZrušit/api/v1/activations/repeatPočet návratů/api/v1/keysAPI Klíče/api/v1/keysVytvořte klíč/api/v1/keys/{id}Změna názvu nebo politiky/api/v1/keys/{id}Odvolání klíče/api/v1/referralsReferenční kód a výnosy/api/v1/summaryBalance a shrnutí/api/v1/balancePozastaveno/api/v1/ledgerZiskové ledgery/api/v1/withdrawalsŽádosti o platbu/api/v1/withdrawalsVytvořte žádost/api/v1/statisticsCelková statistika/api/v1/earnings/holdsPozastavení výdělkůPřijímání pouze nových SMS
GET /api/v1/activations/42/sms?after_id=0&limit=100
Authorization: Bearer YOUR_API_KEY{
"session_id": 42,
"sms": [
{
"id": 101,
"code": "001234",
"text": "Kód: 001234",
"sender": "Service",
"received_at": "2026-10-09T12:00:00Z"
}
],
"next_cursor": 101,
"has_more": false
}Zachránit next_cursor a předávám to jako after_id. Pokud has_more=true, další stránka může být okamžitě čtena. 1–200. Zasedení a SMS jsou k dispozici pouze pro vlastníku.