Numbrid, sõnumid ja tulu, otse teie rakenduse kaudu.
SMScash
API dokumentatsioon
Alustamine

API dokumentatsioon

Numbrid, sõnumid ja tulu, otse teie rakenduse kaudu.

Alustage ühe taotlusega

13 · API käskREST + handler_api.phpJSON / plain text · Bearer

Luua oma tahvelarvuti API-tõu, saada number ja kontrollida sõnumid iga 20 sekundi tagant. makse võetakse krediidi, kui SMS koodiga saabub; uuesti lugemine ei mõjuta teie tasakaalu.

REST APIhttps://smscash.org/api/v1
Ühilduvus API baasi URLhttps://smscash.org/stubs/handler_api.php
Teenus on elustelefoni numbrid , SMS ja kasumid on kättesaadavad. tagasivõtmised on saadaval USDT Üle TRC20Maksed võtavad vahele 1 ja 45 päevadest .
Kiire algus · 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}'

Alternatiivne ühilduv vahenduse aadress: /handler_api.php. olemasolevad REST integreeringud töötavad jätkuvalt.

REST API

Päringute koostaja

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automaatne valik: kõige rohkem koode viimase tunni, seejärel 24 tunni jooksul. Numbreid pole: järgmine operaator.

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

Võtit ei salvestata. See kontroll ei väljasta numbreid.

Uute integratsioonide jaoks

Teenused ja riigid

Teenuse ja riigi valimine. SMS-i kaudu maksmine sõltub riigist.

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)

Saada number
REST
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

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

Automaatne valik: kõige rohkem koode viimase tunni, seejärel 24 tunni jooksul. Numbreid pole: järgmine operaator.

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

See number on kehtiv 20 minutit. SMS kontrollitakse iga 20 sekundi tagant.

Kontrolli mitut numbrit
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
Saldo · Ootel
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 — Saadaval; held_balance — Ootel. USD · 8

Välja saab võtta ainult raha, mille ooteaeg on lõppenud.

Kasutusvalmis kliendid

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 · Ühilduvus API baasi URLhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Ühilduvus API baasi URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Kasutaja isiklik API võti.

Teenuse ja riigi valimine. SMS-i kaudu maksmine sõltub riigist.

Kodukirjeldus
getNumber / getNumberV2Saada number
getStatus / getStatusV2Saada uusim kood
setStatus / finishActivation / cancelActivationJuhtimise istung
getPrices / getNumbersStatusKontrolli kättesaadavus
getRewards (SMScash)SMS-i eest tasu
getServicesList / getServicesTeenused
getCountries / getOperatorsTeenused ja riigid
getActiveActivationsistungid
getBalanceKasutaja saldo
getHoldBalance (SMScash)Ootel

cost = 0 USD · activationCost = 0 USD
reward — SMS-i eest tasu

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'
vastused
{
  "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.

See number on kehtiv 20 minutit. SMS kontrollitakse iga 20 sekundi tagant.

Autentimine ja taganemine

REST: pealkiri Authorization: Bearer YOUR_API_KEY. Ühilduv ühendus: Parameetrid api_key ja actionKasutage HTTPS’i

API-lõike haldamiseks sisestage oma konto.

∞Soovitused / min konto kohta
∞Samaaegsed istungid

API nõudmise sagedus ja telefoninumber on piiramatu. ei ole igapäevaseid või tunni kvooteid.

See number on kehtiv 20 minutit. SMS kontrollitakse iga 20 sekundi tagant.

Ülejäänud, ainulaadne Idempotency-Key on vajalik numbrite allokatsiooniks, korduv allokatsioon, taganemis- ja makseküsimused. see on valikuline, kuid soovitatav handler_api.php. võrguküsimuse taganemiseks kasutatakse uuesti võtme; uue tegevuse jaoks kasutatakse uut võtme.

API võtmevaldkond

Võite piirata võtme konkreetsetele teenustele, riikidele ja pakkujatele. tühjad loendid võimaldavad kõiki olemasolevaid võimalusi.

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

PATCH /api/v1/keys/{id} Muuda nime ja poliitikat täielikult. saladus on näidatud ainult siis, kui see on loodud.

10% kokku. 5% + 5% tarkvara koodiga.

Kui te arvete välja andmisel palun esitage ref tarkvara omanik. taotlus on volitatud täitja võtme poolt. kood on "Referrals" ja GET /api/v1/referrals → software_ref.

nõudmineKutsumetarkvara
Ilma reefita10%—
Ühes ref5%5%
Reefiga, ilma referendita—5%

Platvorm maksab boonuse ilma kasutaja tulu vähendamata. tarkvara omanik ja viitaja võivad olla sama isik. Kasutaja ei saa kasutada oma koodi.

Aegad on kindlaks määratud, kui istung luuakse; lugemine SMS ja tagasipöördumine ei muuda neid. uuesti uuesti uuesti kordamise istung. tariifide arvutamisel annab kasutaja auhind USD 0.003 USD 0.00015 igaühe tarkvara omanikule ja viiteandjale. koguponus on USD 0.00030.

API käsk

11 XVBC-tüüpi meetodid plus teie SMScash tasakaal.

GETgetNumberSaada number

Loodab seanss ja hoiab kasutajatele kättesaadavaks number. palga ja viitamise saajate tasu määratakse allahindlusel; palga võetakse krediidi, kui SMS koodiga saabub.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
service*stringTeenuskoodid: vastus on piiratud API võtme piirkonnaga.
country*integerVõtke ID getCountries.
operatorstringVõtke ID operators/getOperators (API). operator=1 · any/0
session_durationintegerSeanss kestab 20 minutit. lähen 20 või eirage see parameeter.
with_operatorinteger1 lisab vastusele operaatori ID; 0 või parameetri puudumine tagastab kolm osa.
refstringTarkvara omaniku avalik kood: 5% temale ja 5% külastajale. ilma ref - 10% külastajale.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getNumber.

Näiteks taotlus

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'

vastused

Saadetud number
ACCESS_NUMBER:42:380670000000:1
Ei ole olemas numbreid
EMPTY_POOL
  • Automaatne valik: kõige rohkem koode viimase tunni, seejärel 24 tunni jooksul. Numbreid pole: järgmine operaator.
  • Pass Idempotency-Key: sama nõudlus sama võtme tagastab eelmisele istungile. muutes parameetreid kutsub IDEMPOTENCY_CONFLICT.
  • Numeriline riik ilma poolita annab EMPTY_POOL; vale riikformaat on BAD_COUNTRY.
  • Väljendatud istungi võtme kasutamine jääb: selle võtme allikaadi taasesitamine tagastab SESSION_CLOSED ja ei väljastata uut numbrit.
  • Eraldamise tulemus on kinnitamata. automaatne tagasivõtmine on keelatud, et vältida teise numbri eraldamist.
GETgetNumbersStatusKontrolli kättesaadavus

Saadavad telefoninumbrid teenuse ja riigi järgi.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
country*integerVõtke ID getCountries.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getNumbersStatus.

Näiteks taotlus

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

vastused

saadaval olevad numbrid
{
  "go_0": 0
}
  • _0 suffix tähendab valikut ilma konkreetse operatori.
  • Saadavus viitab tarnija üldisele poolile. valitud kanal kontrollitakse, kui number on eraldatud.
GETgetStatusSaada uusim kood

Lihtne taotlus istungi seisundi ja viimase SMS-koodiga. koodi juhtivad nullid on säilinud.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
id*integerTeie istungi ID, mis on saadud, kui number on välja antud.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getStatus.

Näiteks taotlus

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

vastused

Ootades
STATUS_WAIT_CODE
Saadud kood
STATUS_OK:001234
tühistamine või lõppemine
STATUS_CANCEL
Ei leitud
NO_ACTIVATION
  • Poll iga 20 sekundi tagant. uudse sõnumi lugemine ei tekita uut makse.
  • Pärast retry vana kood ei tagasi: getStatus ootab järgmiselt SMS.
  • Kui arv ilma SMS on kustutatud, getStatus ja getSms Tagasitulek STATUS_CANCEL; getSmsFull Tagastab suletud seisundi, tühja telefoni ja tühja sms Üks nimekiri. REST /activations/{id} ja /sms Tagasitulek 404 NO_ACTIVATION.
GETsetStatusJuhtimise istung

Lõpetab, tühistab või uuesti ootab SMS-i. istung lõpeb samal ajal.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
id*integerTeie istungi ID, mis on saadud, kui number on välja antud.
status*integer3 — oodake järgmist koodi, pikendamata istungit; 6 — lõpetage pärast SMS; 8 — kohe tühistada.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =setStatus.

Näiteks taotlus

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'

vastused

Ootame SMS-i
ACCESS_RETRY_GET
Lõpetatud
ACCESS_ACTIVATION
tühistatud
ACCESS_CANCEL
  • Tagasisaatmine ootab järgmist koodi algsete 20 minuti jooksul. väljumise ja lõpptähtaeg ei muutu.
  • Seega on status =3 Kasutamine Idempotency-Key* kordamine taotlus ei uuenda uue koodi, mis on juba saadud. SMS jääb kättesaadavaks.
  • Tühistamine ei eemaldata juba teenitud auhindu.
  • Ajalugu säilitatakse ainult numbrid, millel on SMS-kood. tühistatud ja aegunud numbrid ilma koodita kustutatakse.
GETgetRepeatNumberÜtle sama number uuesti

Avage uus seanss, millel on teie ajaloos teatav number.Saate valida teise kättesaadavuse teenuse samas riigis.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
number*stringAinult numbrid ja valikuline juhtiv + on lubatud.
service*stringTeenuskoodid: vastus on piiratud API võtme piirkonnaga.
session_durationintegerSeanss kestab 20 minutit. lähen 20 või eirage see parameeter.
with_operatorinteger1 lisab vastusele operaatori ID; 0 või parameetri puudumine tagastab kolm osa.
refstringTarkvara omaniku avalik kood: 5% temale ja 5% külastajale. ilma ref - 10% külastajale.
operatorstringVõtke ID operators/getOperators (API). operator=1 · any/0

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getRepeatNumber.

Näiteks taotlus

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'

vastused

Uus istung
ACCESS_NUMBER:43:380670000000
Nende arv on ikka veel hõivatud
NUMBER_IN_USE
  • Esiteks lõpetage või tühistage oma praegune seanss. kui number on hõivatud, ei toimu uuesti väljavoolu.
  • Uus seanss saab uue ID ja praeguse tariifi. vana SMS ei kopeeri selle. ref on uuesti määratud.
  • SMScash võimaldab korrata ainult numbreid selle konto ajaloos.
  • Väljendatud istungi võtme kasutamine jääb: selle võtme allikaadi taasesitamine tagastab SESSION_CLOSED ja ei väljastata uut numbrit.
GETgetSmsFullSaada SMS kui JSON

Struktureeritud ajalugu kõikide sõnumite ID, saatja, kood, teksti ja riigi, teenuse ja tarnija andmed.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
id*integerTeie istungi ID, mis on saadud, kui number on välja antud.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getSmsFull.

Näiteks taotlus

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

vastused

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"
}
  • Soovitud vorming integreerimiseks. mäletage sms[].id töötlemiseks ainult uusi sõnumeid.
  • Numeriline seisund SMScash: 1 - aktiivne, 6 - lõpetatud, 8 - tühistatud või lõppev. status_name eristab ootamise, vastuvõtmise, lõpetamise, tühistamise, lõppevuse vahel.
  • Saadud koodid jäävad kättesaadavad pärast seansi lõpetamist. Suurte koguste puhul kasutatakse REST /activations/{id}/sms koos after_id.
  • Kui arv ilma SMS on kustutatud, getStatus ja getSms Tagasitulek STATUS_CANCEL; getSmsFull Tagastab suletud seisundi, tühja telefoni ja tühja sms Üks nimekiri. REST /activations/{id} ja /sms Tagasitulek 404 NO_ACTIVATION.
GETgetSmsSaada SMS kui teksti string

Tagastab kogu SMS-i ajalugu olemasolevate klientide jaoks stringvormingus.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
id*integerTeie istungi ID, mis on saadud, kui number on välja antud.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getSms.

Näiteks taotlus

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

vastused

Sõnum
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Ootades
STATUS_WAIT_CODE
tühistamine või lõppemine
STATUS_CANCEL
  • Sõnumivorm: aeg-koda-koda tekst. Mitmed sõnumid on eraldatud kolonnaga.
  • Tekst SMS ise võib sisaldada kolonid ja vertikaalsed jooned. usaldusväärse parsingu jaoks kasutage getSmsFull.
GETgetServicesTeenused

Teenuskoodid: vastus on piiratud API võtme piirkonnaga.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
countryintegerVõtke ID getCountries.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getServices.

Näiteks taotlus

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

vastused

Teenused
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Teenuse direktori jagatakse tarnija vahel. numbrite kättesaadavus kontrollitakse eraldi.
GETgetCountriesRiigid

ID-d, nimed ja kõne koodid valitud kanalis riikide jaoks.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getCountries.

Näiteks taotlus

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

vastused

Riigid
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperatorid

Saadaolevad operaatorid: API ID, nimi ja tasu ooteaeg.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
countryintegerVõtke ID getCountries.
operatorstringVõtke ID operators/getOperators (API). operator=1 · any/0

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getOperators.

Näiteks taotlus

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

vastused

Operatorid
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Võtke ID operators/getOperators (API).
GETgetRewardsSMS-i eest tasu

Tasud sõltuvad riigist. Kõik tabelimäärad on tasutud SMS.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.
countryintegerVõtke ID getCountries.
servicestringTeenuskoodid: vastus on piiratud API võtme piirkonnaga.
operatorstringVõtke ID operators/getOperators (API). operator=1 · any/0

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getRewards.

Näiteks taotlus

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

vastused

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD tariifimäärad tagastatakse täpselt kümnendikuna, kus on 8 kümnendikuna:
  • Teie võtme jaoks kättesaadavad pakkujad.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceKasutaja saldo

Lisatud SMScash: saadaval tasakaal, võttes arvesse akruale, viide boonuseid ja makseküsimusi.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getBalance.

Näiteks taotlus

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

vastused

Saldo
ACCESS_BALANCE:0.00
  • getBalance tagasi kättesaadav USD tasakaalu kuni 8 desimaalne kohta.
  • Välja saab võtta ainult raha, mille ooteaeg on lõppenud.
GETgetHoldBalanceOotel

Pärast SMS saamist hoitakse tulu tarnija määratud aja jooksul kinni. Määratud kuupäeval muutub summa automaatselt väljavõetavaks.

Parameetrid

Parameetridtüüpkirjeldus
api_key*stringKasutaja isiklik API võti.

* Nõutav parameeter. kõigis taotlustes läbib ka tegevus =getHoldBalance.

Näiteks taotlus

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

vastused

Ootel
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Välja saab võtta ainult raha, mille ooteaeg on lõppenud.

Vastuse koodid ja korduvad taotlused

Selles handler_api.php äritulemused tavaliselt tulevad koos HTTP 200Vaata ka tekstit, juhiseid ja getSmsFull Tagasitulek JSON Kui see on edukas, siis vigu on alati tekst.

KoduHTTPPõhjus ja järgmine samm
TARIFF_NOT_CONFIGURED200Tasud ei ole veel kindlaks määratudNumbrite allokatsioon algab pärast SMS-i auhindade konfigureerimist.
COUNTRY_BLOCKED200Selle riigi numbrite eraldamine on blokeeritud.Valige teine riik.
BAD_SERVICE200Selle teenuse numbrite allokatsioon on blokeeritud.Valige teine teenus.
PROVIDER_NOT_READY200Numbrite allokatsioon on ajutiselt kättesaadavVärskenda API kataloogid.
BAD_KEY400Ei api_key või kehtiv formaat.Kontrollige taotluses võtme.
INVALID_API_KEY401Märks ei ole teada, tühistatud või konto on välja lülitatud.Looge kehtiv API võtmed.
BAD_COUNTRY400Riik on puudu või ei ole positiivne number.Võtke ID getCountries.
BAD_SESSION_DURATION400Telefoninumbrid on välja antud täpselt 20 minutit.Korrekt session_duration.
BAD_REQUEST400kehtiva parameetri või Idempotency-Key.Palun parandage oma taotlust.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Tuntud või puudulikud direktori esemed.Värskenda API kataloogid.
BAD_NUMBER200Väärne number vorming.Andke number numbriks.
BAD_ACTION / BAD_STATUS200Teadmata käsk, ID või operatsioon.Vaadake seadistusi.
EMPTY_POOL200Praegu ei ole vastavaid telefoninumbreid saadaval.Korda pärast 10-30 sekundit või muuta filtreid.
NUMBER_IN_USE200Teatud arv hõlmab aktiivset istungit.Lõpetage seanss või valige teine number.
NO_ACTIVATION200Seanss või eelmine number ei kuulu teie kontole.Kontrollige ID ja võtmed.
SESSION_CLOSED / SMS_REQUIRED200Praegu ei ole riiklik üleminek kättesaadav.Kontrollige SMSi tingimust ja kättesaadavust.
SCOPE_BLOCKED200Teenus, riik või tarnija ei ole võtme jaoks lubatud.Päevastage API võtme ulatust.
IDEMPOTENCY_CONFLICT200See küsimustik on juba seotud teiste parameetritega.Uue operatsiooni jaoks looge uus Idempotency-Key.
BAD_REF / SELF_REF400Tarkvara kood on teadmata, puudulik või kuulub kasutaja enda.Kontrollige tarkvara omaniku koodi.
INTERNAL_ERROR500ajutine server või tarnija viga.Korda viivitamisega ja samaga Idempotency-Key.
ALLOCATION_PENDING200Number jaotus on juba edaspidi. Võta ühe samaga Idempotency-Key.Number jaotus on juba edaspidi. Võta ühe samaga Idempotency-Key.
ALLOCATION_UNCERTAIN200Eraldamise tulemus on kinnitamata. automaatne tagasivõtmine on keelatud, et vältida teise numbri eraldamist.Eraldamise tulemus on kinnitamata. automaatne tagasivõtmine on keelatud, et vältida teise numbri eraldamist.

REST tagastab objekti {"error":{"code":"…","message":"…"}} HTTP-i staatused on 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Kontrollige taotluse valdkondi.",
    "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.

Uute integratsioonide jaoks

USD tariifimäärad tagastatakse täpselt kümnendikuna, kus on 8 kümnendikuna: 0.00300000 USD.

Tasakaalu valuuta on USD. nõudluse ja vastuse skeemid on saadaval OpenAPI.

Tagasi välja arvutamine USDT · TRC20Väljamaksed võtavad aega 1 kuni 45 päeva. Väljamakse teenustasu on 4 $. See arvatakse taotletud summast maha. Pärast SMS saamist hoitakse tulu tarnija määratud aja jooksul kinni. Määratud kuupäeval muutub summa automaatselt väljavõetavaks. Välja saab võtta ainult raha, mille ooteaeg on lõppenud.
GET/api/v1/catalogTeenused ja riigid
GET/api/v1/tariffsSMS palga hinnad riigis
GET/api/v1/offersTasud ja auhinnad
GET/api/v1/servicesDirektorid
GET/api/v1/countriesDirektorid
GET/api/v1/operatorsDirektorid
GET/api/v1/availability?country=1Numbrit saadaval
POST/api/v1/activationsUus istung
GET/api/v1/activations/batch?ids=42,43Kontrolli mitut numbrit
GET/api/v1/activationsViimane 200 istungit: ulatus = ajalugu, ootus või kõik
GET/api/v1/activations/{id}Istung ja sõnumid
GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS koos kursoriga
POST/api/v1/activations/{id}/retryOotame SMS-i
POST/api/v1/activations/{id}/finishLõpetamine
POST/api/v1/activations/{id}/canceltühistada
POST/api/v1/activations/repeatNumbriline tagasivõtmine
GET/api/v1/keysAPI võtmed
POST/api/v1/keysLooge võti
PATCH/api/v1/keys/{id}Nimi või poliitika muutmine
DELETE/api/v1/keys/{id}Tagasi võtmed
GET/api/v1/referralsReferentkood ja tulu
GET/api/v1/summaryTasakaal ja kokkuvõte
GET/api/v1/balanceOotel
GET/api/v1/ledgerKasumid LEDGER
GET/api/v1/withdrawalsMakseküsimused
POST/api/v1/withdrawalsLooge taotlus
GET/api/v1/statisticsÜldised statistika
GET/api/v1/earnings/holdsTulude ooteaeg

Saada ainult uus SMS

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": "Kood: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

päästa next_cursor ja selle üle, kui after_idKui has_more=trueJärgmise lehekülge saab lugeda kohe. limit: 1–200istungid ja SMS See on kättesaadav ainult omanikule.