Számok, üzenetek és nyereségek, közvetlenül az alkalmazásból.
SMScash
API dokumentáció
Kezdődik a

API dokumentáció

Számok, üzenetek és nyereségek, közvetlenül az alkalmazásból.

Kezdjük egy kéréssel

13 · API parancsokREST + handler_api.phpJSON / plain text · Bearer

Hozzon létre egy API kulcsot a táblagépben, kap egy számot, és ellenőrizze az üzenetek minden 20 másodpercben. A fizetést hitelezik, amikor egy SMS-t egy kódmal érkezik; újra olvasása nem befolyásolja az egyensúlyt.

REST APIhttps://smscash.org/api/v1
kompatibilitási API bázis URLhttps://smscash.org/stubs/handler_api.php
A szolgáltatás éltelefonszámok , SMS A nyereség elérhető, a visszavonások elérhetőek USDT Azon TRC20A kifizetések között 1 és 45 A napok.
Gyors indítás · REST / cURL
curl -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}'

Alternatív kompatibilis interfész cím: /handler_api.php. A meglévő REST integrációk továbbra is működnek.

REST API

Kéréskészítő

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automatikus választás: a legtöbb kód az elmúlt órában, majd 24 órában. Nincs szám: következő szolgáltató.

cURL
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}'

A kulcsot nem tároljuk. Ez az ellenőrzés nem oszt ki számokat.

Új integrációkért

Szolgáltatások és országok

Válasszon egy szolgáltatást és országot. A fizetési SMS-t az országtól függ.

REST
GET /api/v1/catalog?service=go&country=86&page=1&page_size=100
Authorization: Bearer YOUR_API_KEY
JSON
{
  "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)

Kapjon egy számot
REST
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

{
  "service": "go",
  "country": 86
}

Automatikus választás: a legtöbb kód az elmúlt órában, majd 24 órában. Nincs szám: következő szolgáltató.

REST
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

A szám érvényes 20 perc. SMS ellenőrzés minden 20 másodperc.

Több szám ellenőrzése
REST
GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY
JSON
{
  "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
}
REST
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 message
Egyenleg · Visszatartva
REST
GET /api/v1/balance
Authorization: Bearer YOUR_API_KEY
JSON
{
  "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 — Elérhető; held_balance — Visszatartva. USD · 8

Csak a már lejárt visszatartási idejű pénz fizethető ki.

Használatra kész kliensek

JavaScript · Node.js 18+
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 string
Python 3.9+
import 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 string
SDK
me() · 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

SMS-Activate · kompatibilitási API bázis URLhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · kompatibilitási API bázis URLhttps://smscash.org/hero-sms/stubs/handler_api.php

A felhasználó személyes API-kulcsa.

Válasszon egy szolgáltatást és országot. A fizetési SMS-t az országtól függ.

kódleírás
getNumber / getNumberV2Kapjon egy számot
getStatus / getStatusV2Szerezze meg a legújabb kódot
setStatus / finishActivation / cancelActivationÜlés menedzsment
getPrices / getNumbersStatusEllenőrizze a rendelkezésre állást
getRewards (SMScash)SMS díj
getServicesList / getServicesSzolgáltatások
getCountries / getOperatorsSzolgáltatások és országok
getActiveActivationsülések
getBalanceFelhasználói egyenleg
getHoldBalance (SMScash)Visszatartva

cost = 0 USD · activationCost = 0 USD
reward — SMS díj

HeroSMS · cURL
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'
Válaszok
{
  "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"
}
SMS-Activate / HeroSMS
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.

A szám érvényes 20 perc. SMS ellenőrzés minden 20 másodperc.

A hitelesítés és a visszavonulás

REST: fejjel Authorization: Bearer YOUR_API_KEY. Kompatibilis felületek: paraméterek api_key és actionHasználja a HTTPS-t

Az API-kulcsok kezeléséhez lépjen be a fiókjába.

∞Kérések / perc számlára
∞Egyidejű ülések

Az API-kérések gyakorisága és a telefonszámok száma korlátlan. nincs napi vagy órás kvóta.

A szám érvényes 20 perc. SMS ellenőrzés minden 20 másodperc.

A többi, egyedi Idempotency-Key számok elosztására, ismételt elosztásra, visszavonásra és kifizetési kérésekre van szükség. Ez opcionális, de ajánlott handler_api.php. A kulcs újra használata a hálózati kérés visszavonásakor; új kulcsot használjon egy új művelethez.

API kulcsfelület

A kulcsot korlátozhatja a konkrét szolgáltatásokra, országokra és szolgáltatókra. üres listák lehetővé teszik az összes rendelkezésre álló lehetőséget.

JSON
{
  "label": "A szoftver",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} A név és a politika teljesen megváltozik.A titok csak akkor jelenik meg, amikor létrehozott.

10% -a összesen. 5% + 5% szoftver kód.

Ha számot adunk ki, kérjük, adjon ref a szoftver tulajdonosa.A kérelem a végrehajtó kulcsa által engedélyezett.A kód a "Referrals" szakaszban található, és a GET /api/v1/referrals → software_ref.

KérésMeghívószoftver
Nem Ref10%—
A ref5%5%
A ref, nem referrer—5%

A platform a bónuszt fizet anélkül, hogy a felhasználó jövedelmeit csökkenné.A szoftver tulajdonosa és a referrer ugyanaz lehet.A felhasználó nem használhatja a saját kódját.

A határidők rögzítettek, amikor egy ülés jön létre; olvasás SMS és visszavonás nem változtatja meg őket. átadja a ref újra egy új ismétlődő ülés. A díjszámításban a felhasználó jutalom USD 0.003 ad USD 0.00015 mind a szoftver tulajdonos és a referrer. A teljes bónusz USD 0.00030.

API parancsok

11 XVBC stílusú módszerek plusz az SMScash egyensúly.

GETgetNumberKapjon egy számot

A jutalom és a referenciamutató a jutalomra kerül; a jutalom akkor kerül megítélésre, amikor egy SMS-t ér el a kódmal.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
service*stringA válasz korlátozott az API kulcs területére.
country*integerVegyünk egy ID-t a getCountries-ból.
operatorstringVegyünk egy ID-t a operators/getOperators (API)-ból. operator=1 · any/0
session_durationintegerA szezon 20 percet vesz igénybe. 20 át vagy hagyja ki ezt a paraméteret.
with_operatorintegerAz 1 hozzáadja az operátor ID-jét a válaszhoz; a 0 vagy az elhagyott paraméter három részt ad vissza.
refstringA szoftver tulajdonosának nyilvános kódja: 5% Ő és 5% A meghívó számára. nélkül ref - 10% A meghívóhoz tartozik.

* Szükséges paraméter. minden kérésben is lépés =getNumber.

Példaként kérjük

curl
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'

Válaszok

Kiadott szám
ACCESS_NUMBER:42:380670000000:1
Nincs elérhető szám
EMPTY_POOL
  • Automatikus választás: a legtöbb kód az elmúlt órában, majd 24 órában. Nincs szám: következő szolgáltató.
  • Szállás Idempotency-Key: ugyanaz a kérelem ugyanez a kulcsával visszatér az előző ügynökséget. A paraméterk változtatása IDEMPOTENCY_CONFLICT.
  • A számjegyű ország, amely nem rendelkezik egy öltözékkel, EMPTY_POOL-t ad; a rossz országformátum a BAD_COUNTRY.
  • A törölt ülés kulcsa továbbra is használatos: az elosztás újrajátszása ezzel a kulcsmal visszatér a SESSION_CLOSED-hez, és nem ad ki más számot.
  • Az elosztás eredménye nem igazolt.Az automatikus visszavonás nem engedélyezett, hogy elkerülje a második szám elosztását.
GETgetNumbersStatusEllenőrizze a rendelkezésre állást

A telefonszámok állnak rendelkezésre szolgálat és ország szerint.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
country*integerVegyünk egy ID-t a getCountries-ból.

* Szükséges paraméter. minden kérésben is lépés =getNumbersStatus.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86'

Válaszok

rendelkezésre álló számok
{
  "go_0": 0
}
  • A _0 suffix egy adott operátor nélkül történő választás.
  • A rendelkezésre állás a beszállító teljes medencéjére utal.A kiválasztott csatorna ellenőrzése akkor történik, amikor egy számot osztanak ki.
GETgetStatusSzerezze meg a legújabb kódot

Könnyű kérés az ülés állapotára és az utolsó SMS-kódra. A kód vezető zéróit megőrzik.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
id*integerAz Ön ülésének azonosítója, amelyet a szám kiadásakor kaptak.

* Szükséges paraméter. minden kérésben is lépés =getStatus.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42'

Válaszok

Várakozás
STATUS_WAIT_CODE
Megkapott kód
STATUS_OK:001234
törlés vagy lejárat
STATUS_CANCEL
Nem talált
NO_ACTIVATION
  • 20 másodpercenként.Egy üzenet újra olvasása nem hoz létre további fizetéseket.
  • Után retry a régi kód nem visszatérték: getStatus Várja a következőt SMS.
  • Egy szám után, ha nem SMS eltávolításra kerül, getStatus és getSms Visszatérés STATUS_CANCEL; getSmsFull Visszaadja a zárt állapotot, egy üres telefont és egy üres sms A listát. REST /activations/{id} és /sms Visszatérés 404 NO_ACTIVATION.
GETsetStatusÜlés menedzsment

Véget ér, törli vagy újra vár SMS. A szünet lejár ugyanaz marad.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
id*integerAz Ön ülésének azonosítója, amelyet a szám kiadásakor kaptak.
status*integer3 – várja a következő kódot a szezon meghosszabbítása nélkül; 6 – befejeződik az SMS után; 8 – azonnal törli.

* Szükséges paraméter. minden kérésben is lépés =setStatus.

Példaként kérjük

curl
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'

Válaszok

SMS-re várunk
ACCESS_RETRY_GET
befejezett
ACCESS_ACTIVATION
törlés
ACCESS_CANCEL
  • A visszavonás az eredeti 20 percen belül várja a következő kódot. a kiadás és a lejárati idő nem változik.
  • A helyzet =3 Használat Idempotency-Key: a kérelem megismétlődése nem helyezheti vissza a már megkapott új kódot. SMS elérhető marad.
  • A törlés nem törli a már megszerzett jutalmakat.
  • Csak az SMS-kódot tartalmazó számok tárolódnak a történelemben. törölt és kimerült számok kód nélkül törlődnek.
GETgetRepeatNumberIsmét ugyanazt a számot adja meg

Nyissa meg egy új üléset, amely egy adott számot tartalmaz a történelméből. Ön kiválaszthat egy másik elérhető szolgáltatást ugyanazon az országban.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
number*stringCsak a számok és az opcionális vezető + engedélyezhető.
service*stringA válasz korlátozott az API kulcs területére.
session_durationintegerA szezon 20 percet vesz igénybe. 20 át vagy hagyja ki ezt a paraméteret.
with_operatorintegerAz 1 hozzáadja az operátor ID-jét a válaszhoz; a 0 vagy az elhagyott paraméter három részt ad vissza.
refstringA szoftver tulajdonosának nyilvános kódja: 5% Ő és 5% A meghívó számára. nélkül ref - 10% A meghívóhoz tartozik.
operatorstringVegyünk egy ID-t a operators/getOperators (API)-ból. operator=1 · any/0

* Szükséges paraméter. minden kérésben is lépés =getRepeatNumber.

Példaként kérjük

curl
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'

Válaszok

Új ülés
ACCESS_NUMBER:43:380670000000
A szám még mindig elfoglalt
NUMBER_IN_USE
  • Először is, végezze el vagy törölje a jelenlegi ülését. Ha a szám elfoglalt, az újbóli kiadás nem történik.
  • Az új ülés új ID-t és a jelenlegi díjat kap. A régi SMS-eket nem másolják. ref újra beállítva.
  • A SMScash csak a számok megismétlését teszi lehetővé a fiók történetéből.
  • A törölt ülés kulcsa továbbra is használatos: az elosztás újrajátszása ezzel a kulcsmal visszatér a SESSION_CLOSED-hez, és nem ad ki más számot.
GETgetSmsFullSMS-t kapj JSON

Az összes üzenet története azonosítóval, küldővel, kódmal, szöveg és ország, szolgáltatás és beszállító adataikal.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
id*integerAz Ön ülésének azonosítója, amelyet a szám kiadásakor kaptak.

* Szükséges paraméter. minden kérésben is lépés =getSmsFull.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42'

Válaszok

JSON
{
  "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"
}
  • A preferált formátum integrációhoz. Emlékezz SMS[].id csak új üzenetek feldolgozásához.
  • A numerikus állapot SMScash: 1 - aktív, 6 - befejezett, 8 - törölt vagy lejár. status_name különbséget tesz a várakozás, a kapott, a befejezett, a törölt, a lejárat között.
  • A kapott kódok a szezon lezárása után is elérhetőek maradnak. nagy mennyiségűek esetén használja a REST /activations/{id}/sms after_id.
  • Egy szám után, ha nem SMS eltávolításra kerül, getStatus és getSms Visszatérés STATUS_CANCEL; getSmsFull Visszaadja a zárt állapotot, egy üres telefont és egy üres sms A listát. REST /activations/{id} és /sms Visszatérés 404 NO_ACTIVATION.
GETgetSmsSMS-t kapsz szövegszalagként

Visszaadja az egész SMS-t a meglévő ügyfelek számára a sorformátumban.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
id*integerAz Ön ülésének azonosítója, amelyet a szám kiadásakor kaptak.

* Szükséges paraméter. minden kérésben is lépés =getSms.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42'

Válaszok

üzenet
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Várakozás
STATUS_WAIT_CODE
törlés vagy lejárat
STATUS_CANCEL
  • Üzenetformátum: időkód, üzenettext. Több üzenet oszlik meg egy oszlop.
  • A szöveg SMS magában tartalmazhat oszlopok és függőleges lapok. megbízható parsing, használja getSmsFull.
GETgetServicesSzolgáltatások

A válasz korlátozott az API kulcs területére.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
countryintegerVegyünk egy ID-t a getCountries-ból.

* Szükséges paraméter. minden kérésben is lépés =getServices.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY'

Válaszok

Szolgáltatások
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • A szolgáltatási címkét a szállító között osztják meg. A rendelkezésre állás számát külön ellenőrizzük.
GETgetCountriesOrszágok

Az országok azonosítói, nevei és hívó kódjai a kiválasztott csatornán.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.

* Szükséges paraméter. minden kérésben is lépés =getCountries.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY'

Válaszok

Országok
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperátorok

Elérhető operátorok: API-azonosító, név és a jutalom zárolási ideje.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
countryintegerVegyünk egy ID-t a getCountries-ból.
operatorstringVegyünk egy ID-t a operators/getOperators (API)-ból. operator=1 · any/0

* Szükséges paraméter. minden kérésben is lépés =getOperators.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY'

Válaszok

Operátorok
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Vegyünk egy ID-t a operators/getOperators (API)-ból.
GETgetRewardsSMS díj

Az ár az országtól függ. Minden táblázatösszeg fizetett SMS-re vonatkozik.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.
countryintegerVegyünk egy ID-t a getCountries-ból.
servicestringA válasz korlátozott az API kulcs területére.
operatorstringVegyünk egy ID-t a operators/getOperators (API)-ból. operator=1 · any/0

* Szükséges paraméter. minden kérésben is lépés =getRewards.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi'

Válaszok

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • A USD vámösszegeket pontosan tízszeres szálaként térítjük vissza, 8 tízszeres helyet:
  • A kulcsodhoz elérhető szolgáltatók engedélyezése.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceFelhasználói egyenleg

Additional SMScash: elérhető mérleg figyelembe véve a szűkítéseket, referral bónuszokat és a fizetési kérelmeket.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.

* Szükséges paraméter. minden kérésben is lépés =getBalance.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY'

Válaszok

Egyenleg
ACCESS_BALANCE:0.00
  • getBalance a rendelkezésre vonatkozó USD összefüggés 8 decimal helyek.
  • Csak a már lejárt visszatartási idejű pénz fizethető ki.
GETgetHoldBalanceVisszatartva

Az SMS beérkezése után a bevételt a szolgáltató által meghatározott ideig visszatartjuk. A megadott napon az összeg automatikusan kifizethetővé válik.

Paraméterek

Paramétertípusleírás
api_key*stringA felhasználó személyes API-kulcsa.

* Szükséges paraméter. minden kérésben is lépés =getHoldBalance.

Példaként kérjük

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY'

Válaszok

Visszatartva
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Csak a már lejárt visszatartási idejű pénz fizethető ki.

Válasz kódok és ismételt kérések

Bőve handler_api.php üzleti eredmények általában érkezik HTTP 200. Nézd a testszöveg. getSmsFull vissza JSON ha sikeres; a hibák mindig szövegnek.

kódHTTPAz ok és a következő lépés
TARIFF_NOT_CONFIGURED200Az árfolyamok még nem állapították megA számok elosztása az SMS-díjak beállításakor kezdődik.
COUNTRY_BLOCKED200Az ország számát blokkolják.Válasszon egy másik országot.
BAD_SERVICE200A szolgáltatás számának elosztása blokkolva van.Válasszon egy másik szolgáltatást.
PROVIDER_NOT_READY200A számok átmeneti elosztása nem áll rendelkezésreA API katalógusokat frissítjük.
BAD_KEY400Nem api_key vagy megfelelő formátum.Ellenőrizze a kulcsot a kérésben.
INVALID_API_KEY401A kulcs ismeretlen, visszavonva vagy a fiók kikapcsolva.Hozzon létre egy érvényes API kulcsot.
BAD_COUNTRY400A szám hiányzik vagy nem pozitív.Vegyünk egy ID-t a getCountries-ból.
BAD_SESSION_DURATION400A telefonszámokat pontosan 20 percre adják ki.Igazság session_duration.
BAD_REQUEST400Nem hiányos paraméter vagy Idempotency-Key.Kérjük, javítsa a kérését.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Ismeretlen vagy meghibásodott címkével ellátott elem.A API katalógusokat frissítjük.
BAD_NUMBER200Hiba a számformátumban.Adja meg a számot a számokban.
BAD_ACTION / BAD_STATUS200Ismeretlen parancs, azonosító vagy művelet.Ellenőrizze a beállításokat.
EMPTY_POOL200Jelenleg nincs megfelelő telefonszám.Ismételje meg 10-30 másodperc után vagy változtassa meg a szűrőket.
NUMBER_IN_USE200Egy adott számot egy aktív ülés foglalja el.Végezze el az ülését, vagy válasszon egy másik számot.
NO_ACTIVATION200A szezon vagy az előző szám nem tartozik a fiókjához.Ellenőrizze az ID és a kulcsot.
SESSION_CLOSED / SMS_REQUIRED200Az állami átmeneti rendszer jelenleg nem elérhető.Ellenőrizze az SMS állapotát és rendelkezésre állását.
SCOPE_BLOCKED200A szolgáltatás, az ország vagy a szállító nem engedélyezett a kulcsot.Az API kulcsok terjedelmének frissítése.
IDEMPOTENCY_CONFLICT200Ez a lekérdezés kulcs már kapcsolódik más paraméterekkel.Egy új művelethez hozzon létre egy másik Idempotency-Key-t.
BAD_REF / SELF_REF400A szoftver kód ismeretlen, kikapcsolva, vagy a felhasználó maga tulajdonában van.A szoftver tulajdonosának kódját olvassa el.
INTERNAL_ERROR500Hiba a szolgáltató vagy a szolgáltató hibája.Visszaadni egy készítést és ugyanaz Idempotency-Key.
ALLOCATION_PENDING200A számok elosztása már folyamatban van. visszavonul az azonos Idempotency-Key-vel.A számok elosztása már folyamatban van. visszavonul az azonos Idempotency-Key-vel.
ALLOCATION_UNCERTAIN200Az elosztás eredménye nem igazolt.Az automatikus visszavonás nem engedélyezett, hogy elkerülje a második szám elosztását.Az elosztás eredménye nem igazolt.Az automatikus visszavonás nem engedélyezett, hogy elkerülje a második szám elosztását.

A többi visszaküldi a tárgyat {"error":{"code":"…","message":"…"}} és rendszerű HTTP szabályok 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Ellenőrizze a kérelem mezőit.",
    "request_id": "req_…",
    "hint": "Use the documented JSON type; numbers must not be quoted.",
    "retryable": false,
    "details": {
      "field": "country",
      "expected": "integer"
    }
  }
}
REST
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.

Új integrációkért

A USD vámösszegeket pontosan tízszeres szálaként térítjük vissza, 8 tízszeres helyet: 0.00300000 USD.

A mérleg valuta USD. A kérés és a válasz rendszerek elérhetőek a OpenAPI.

Visszavonás USDT · TRC20A kifizetés 1 és 45 nap közötti időt vesz igénybe. A kifizetés díja 4 $. Ezt a kért összegből vonjuk le. Az SMS beérkezése után a bevételt a szolgáltató által meghatározott ideig visszatartjuk. A megadott napon az összeg automatikusan kifizethetővé válik. Csak a már lejárt visszatartási idejű pénz fizethető ki.
GET/api/v1/catalogSzolgáltatások és országok
GET/api/v1/tariffsSMS díjszedési díj országonként
GET/api/v1/offersÁrak és jutalmak
GET/api/v1/servicesigazgatótanács
GET/api/v1/countriesigazgatótanács
GET/api/v1/operatorsigazgatótanács
GET/api/v1/availability?country=1Szám rendelkezésre állás
POST/api/v1/activationsÚj ülés
GET/api/v1/activations/batch?ids=42,43Több szám ellenőrzése
GET/api/v1/activationsLegutóbbi 200 ülés: scope=history, waiting or all
GET/api/v1/activations/{id}ülés és üzenetek
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Új SMS-ek a kurzorral
POST/api/v1/activations/{id}/retrySMS-re várunk
POST/api/v1/activations/{id}/finishbefejezés
POST/api/v1/activations/{id}/canceltörlés
POST/api/v1/activations/repeatszám visszatér
GET/api/v1/keysAPI kulcsok
POST/api/v1/keysHozzon létre egy kulcsot
PATCH/api/v1/keys/{id}Változtasson nevét vagy politikáját
DELETE/api/v1/keys/{id}Visszavonás kulcs
GET/api/v1/referralsReferenciakód és nyereség
GET/api/v1/summaryEgyensúly és összefoglaló
GET/api/v1/balanceVisszatartva
GET/api/v1/ledgerGyors nyereség
GET/api/v1/withdrawalsFizetési kérelmek
POST/api/v1/withdrawalsKészítsen kérelmet
GET/api/v1/statisticsÖsszes statisztika
GET/api/v1/earnings/holdsBevételek visszatartása

Csak új SMS-eket kapunk

REST
GET /api/v1/activations/42/sms?after_id=0&limit=100
Authorization: Bearer YOUR_API_KEY
JSON
{
  "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
}

mentés next_cursor és átadja azt, mint after_idHa has_more=trueA következő oldal azonnal olvasható. limit: 1–200ülések és SMS Csak a tulajdonos számára elérhető.