Қолданбаңыздан тұтас сандар, хаттар және ықшамдар.
SMScash
API Документация
Қазір қазір

API Документация

Қолданбаңыздан тұтас сандар, хаттар және ықшамдар.

Жабдықтардан кейін

13 · API командасыREST + handler_api.phpJSON / plain text · Bearer

Жасау API перненің қалтаңызда, санды алу мен хаттарды тексеру 20 секунд. SMS Код келетін; оны қайта оқу балансыңыздың таңбасы жоқ.

REST APIhttps://smscash.org/api/v1
Басқасы API URLhttps://smscash.org/stubs/handler_api.php
Қызмет жыйыТелефон нөмірі, SMS және ықтықтар бар. Кескіндер бар USDT келесіде TRC20. Кеңейтулер арасында 1 және 45 күндер.
Тез бастау · 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}'

Алдыңғы қосылды интерфейс адресы: /handler_api.php. іс-әрекеттің REST интеграциялары көптеген жылдар бойы.

REST API

Сұрау құрастырушы

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Автоматты таңдау: соңғы сағатта, содан кейін 24 сағатта ең көп код. Нөмір жоқ болса, келесі оператор.

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

Кілт сақталмайды. Бұл тексеру нөмірлерді бермейді.

Өзініңнің басқа да басқа да

Қызметтер мен елдер

Қызметті мен елді таңдаңыз. SMS елден ықтимал.

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)

Қазіргі таңда
REST
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

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

Автоматты таңдау: соңғы сағатта, содан кейін 24 сағатта ең көп код. Нөмір жоқ болса, келесі оператор.

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

Бұл қағидалар 20 минут ұсынады. SMS-дер 20 секундта дейін аударылады.

Бірнеше нөмірді тексеру
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
Баланс · Ұсталған қаражат
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 — Қолжетімді; held_balance — Ұсталған қаражат. USD · 8

Ұстау мерзімі аяқталған қаражатты ғана шығаруға болады.

Дайын клиенттер

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 · Басқасы API URLhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Басқасы API URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Пайдаланушының жеке API кілті.

Қызметті мен елді таңдаңыз. SMS елден ықтимал.

КодексіОғанды
getNumber / getNumberV2Қазіргі таңда
getStatus / getStatusV2Қазіргі таңда бүкіл әлемдік коды
setStatus / finishActivation / cancelActivationСессияның менеджмент
getPrices / getNumbersStatusҚайтанының дағдыры
getRewards (SMScash)SMS-дер өтірінен
getServicesList / getServicesҚызметтер
getCountries / getOperatorsҚызметтер мен елдер
getActiveActivationsСессиясы
getBalanceПайдаланушының балансы
getHoldBalance (SMScash)Ұсталған қаражат

cost = 0 USD · activationCost = 0 USD
reward — SMS-дер өтірінен

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'
Жауаптар
{
  "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.

Бұл қағидалар 20 минут ұсынады. SMS-дер 20 секундта дейін аударылады.

Аутентификация және ретриация

REST: Әлемдік Authorization: Bearer YOUR_API_KEY. Қазір интерфейс: параметрі api_key Ақыт actionҚайтатын HTTPS

Қандай API-ның кешілер, сіздің акаунтқа қосуға болады.

∞Қандай-ақ, бір-бірімен бір-бірімен
∞Сессиясы

API жабдықтар фреквенциясы және телефондық номері неограничен.

Бұл қағидалар 20 минут ұсынады. SMS-дер 20 секундта дейін аударылады.

Есім мен Қасымның жинақтарында Idempotency-Key санды арнау, қайталану үшін керек, retry және кеңейту сұраулар. Бұл ерекше, бірақ шақырылмаған handler_api.php. Желі сұрауды қайталау кезінде кілтті қайталсын; жаңа әрекет үшін жаңы кілгі қолданыңыз.

API Керіктің

Келтірілген қызметтерге, елдерге және провайдерлерге шектеуге болады. Бос тізімдер барлық параметрлерге рұқсат ететін.

JSON
{
  "label": "Біздің софтвер",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} аты мен ережені толық өзгертеді. Тек құрылғанда ғана құрылды.

10% -ға дейін. 5% + 5% софтвер коды.

Қазіргі таңда бүкіл әлем қаржылық дағдарыс. ref Бағдарламаның иесі. Сұрау орындау кілтінің рұқсат етілген. Код "Кезбеттеу" бөлігіне және "Керістер" дегенде GET /api/v1/referrals → software_ref.

ЖақсыҚазірСофтвер
Ауызды реф10%—
Ауызды реф5%5%
Қандай, қазір мен қазір—5%

Платформа бонустарды ұйымды шектелмейді. Бағдарламаның иесі және реферер бір адам болуға болады. Жұмыстың өзінің кодысын қолдануға болмайды.

Сессия құрылған кезде шарттар орнатылады; оқу SMS мен retry Оларды өзгермейді. ref жаңа қайталанатын сеанс үшін қайталанды. Тариф есептеуде жұмыс ұсқасы USD 0.003 келеді USD 0.00015 әрбір бағдарламаның иесі және референті. Жалпы бонус USD 0.00030.

API командасы

11 XVBC стильді және SMScash балансы бар.

GETgetNumberҚазіргі таңда

Сессияны құру және пайдаланушы үшін бар санды сақталады. Сұрау мен жіберілген алушылар бөлшегіне түсіріледі; сұрақ ықтималда SMS Код келеді.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
service*stringҚолжетерлік қызмет кодтары. Жауаптың аумақтарына шектелмеген API кілт.
country*integerТабу ID келесіден getCountries.
operatorstringТабу ID келесіден operators/getOperators (API). operator=1 · any/0
session_durationintegerҚазіргі таңда 20 минут қанағаттанды. 20 минут қанағаттанды.
with_operatorinteger1 жауапқа оператордың ID-сін қосады; 0 немесе параметр көрсетілмесе, үш бөлік қайтарылады.
refstringСофтвермен салықты коды: 5% және гостем 5%; не реф - 10% гостем.

* Қажетті параметр. Барлық сұрауларда да әрекет=getNumber.

Жақсысы

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'

Жауаптар

Қатысушылардың
ACCESS_NUMBER:42:380670000000:1
Жұмымымы қабығы
EMPTY_POOL
  • Автоматты таңдау: соңғы сағатта, содан кейін 24 сағатта ең көп код. Нөмір жоқ болса, келесі оператор.
  • Парақ Idempotency-Key: сұрау бір пернемен алдыңғы сеансты қайтарады. Параметрлерді өзгерту IDEMPOTENCY_CONFLICT.
  • Ұяшықсыз ел - EMPTY_POOL; қате ел пішімі - BAD_COUNTRY.
  • Өшірілген сеанстың кілттері қолданылады: осы пернемен бөлімді қайта ойнату қайтарады SESION_CLOSED және басқа санды жоқ.
  • Бөлу нәтижесі растаусыз. Автоматты түрде қайталап көру рұқсат етілмеді, екінші санды тарату үшін.
GETgetNumbersStatusҚайтанының дағдыры

Өзінің телефондық номері, қызмет көрсету және қызмет көрсету.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
country*integerТабу ID келесіден getCountries.

* Қажетті параметр. Барлық сұрауларда да әрекет=getNumbersStatus.

Жақсысы

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

Жауаптар

Қатысушылардың
{
  "go_0": 0
}
  • _0 жұрнағы белгілі операторсыз таңдауды анықтау.
  • Қол жеткізбестік табылғыштың жалпы қабылдауы. Таңдалған арна санды талдағанда тексерілген.
GETgetStatusҚазіргі таңда бүкіл әлемдік коды

Бұл үшін, бұл сессиялық статус, SMS код, және бұл кодмен көшіруге болады.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
id*integerБұл үшін бір-бірімен танымал, оның ішінде қазаларынан кейін танымал.

* Қажетті параметр. Барлық сұрауларда да әрекет=getStatus.

Жақсысы

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

Жауаптар

Жүктеу
STATUS_WAIT_CODE
Кодқа қабырға
STATUS_OK:001234
Ауыз және ауқым
STATUS_CANCEL
Не күшiң
NO_ACTIVATION
  • 20 секундта дейін ұлылыңыз.Серіктің бір-бірінен ұлыңыз не басқа да ұлыңыз.
  • Қазір retry Олардың ішіндегі ең көне апеллятив – үңгір. getStatus Қазіргі таңда бүкіл әлемде SMS.
  • Бірнеше сандан кейін SMS өшірілген, getStatus мен getSms қайтару STATUS_CANCEL; getSmsFull жабылған күй- жайы, бос телефон және бос sms тізім. REST /activations/{id} мен /sms қайтару 404 NO_ACTIVATION.
GETsetStatusСессияның менеджмент

SMS күтуді аяқтау, қайту не жалғастыру. Сеанстың мерзімі бірдей болады.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
id*integerБұл үшін бір-бірімен танымал, оның ішінде қазаларынан кейін танымал.
status*integer3 — сессияның ұзақтығы коды туралы жəне; 6 — SMS-дер кейін ұзақтығы; 8 — ұзақтығы ұзақтығы коды туралы жəне.

* Қажетті параметр. Барлық сұрауларда да әрекет=setStatus.

Жақсысы

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'

Жауаптар

SMS-дер қосылды
ACCESS_RETRY_GET
Қатысушы
ACCESS_ACTIVATION
Ақытқы
ACCESS_CANCEL
  • Келесі кодты бастапқы 20 минут ішінде күтеді. Сұрау мен мерзімі біткен уақыттар өзгермейді.
  • Қазір бұл3 Қайта Idempotency-Key• Қазіргі таңда бүкіл әлем қаржылық дағдарыста. SMS Қазіргі таңда да бар.
  • Бұл үшін, банктер өздерінің ең айқын жасайды.
  • Ауыз іші шырышты қабығы SMS Бұл коды туралы қарастырылған.Аздан және басқа да коды туралы қарастырылған.
GETgetRepeatNumberБұл үшін басқа да басқа да басқа да

Тарихыңыздан арналған санмен жаңа сеансты ашу. Бір елде басқа қызметті таңдауға болады.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
number*stringЕскі саныңыз. Тек сандар және бастапқы + ғана рұқсат ететін.
service*stringҚолжетерлік қызмет кодтары. Жауаптың аумақтарына шектелмеген API кілт.
session_durationintegerҚазіргі таңда 20 минут қанағаттанды. 20 минут қанағаттанды.
with_operatorinteger1 жауапқа оператордың ID-сін қосады; 0 немесе параметр көрсетілмесе, үш бөлік қайтарылады.
refstringСофтвермен салықты коды: 5% және гостем 5%; не реф - 10% гостем.
operatorstringТабу ID келесіден operators/getOperators (API). operator=1 · any/0

* Қажетті параметр. Барлық сұрауларда да әрекет=getRepeatNumber.

Жақсысы

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'

Жауаптар

Өткен сессиясы
ACCESS_NUMBER:43:380670000000
Бұл үшін бірнеше ұсыныстар
NUMBER_IN_USE
  • Біріншіден, назардағы сеансыңызды аяқтау не айну. Егер сан бос емес болса, қайта жұмыс істемейді.
  • Бұл үшін жаңа сессиясы және нысандан тарифі ұсынады.Стары SMS-дер не қаталған. ref-дер қайтадан қайтарып.
  • SMScash үшін бұл қабырға айналады.Секреттермен қабырға айналады.
  • Өшірілген сеанстың кілттері қолданылады: осы пернемен бөлімді қайта ойнату қайтарады SESION_CLOSED және басқа санды жоқ.
GETgetSmsFullSMS қауымдастығының ұзақтығы

Барлық хаттар ID, жібергіші, коды, мәтін және ел, қызметтер мен табылғыш деректерін орнату.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
id*integerБұл үшін бір-бірімен танымал, оның ішінде қазаларынан кейін танымал.

* Қажетті параметр. Барлық сұрауларда да әрекет=getSmsFull.

Жақсысы

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

Жауаптар

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"
}
  • Біріккендігін баптау пішімі. sms[].id тек жаңа хаттарды өңдеуді ескерту.
  • Сандар күйі SMScash: 1 - белсенді 6 - аяқталды 8 - тоқтатылды не мерзімі біткен. status_name Күту, қабылдалған, аяқталды, доғарылды, мерзімі біткен.
  • Сеанс жабылғаннан кейін алынған кодтар бар болып тұр. Үлкен үнділігі үшін REST /activations/{id}/sms, after_id көмегімен қолданыңыз.
  • Бірнеше сандан кейін SMS өшірілген, getStatus мен getSms қайтару STATUS_CANCEL; getSmsFull жабылған күй- жайы, бос телефон және бос sms тізім. REST /activations/{id} мен /sms қайтару 404 NO_ACTIVATION.
GETgetSmsSMS-ті тек қағазды

Бар клиенттердің бүкіл SMS журналы мәтін пішімінен қайтарады.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
id*integerБұл үшін бір-бірімен танымал, оның ішінде қазаларынан кейін танымал.

* Қажетті параметр. Барлық сұрауларда да әрекет=getSms.

Жақсысы

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

Жауаптар

Серіктің
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Жүктеу
STATUS_WAIT_CODE
Ауыз және ауқым
STATUS_CANCEL
  • Хабарлама пішімі: time көмек- текст. Бірнеше хаттар бөлігін бөлпейді.
  • Мәтін SMS Өзінің ұзындықтар мен тік панелдері болады. Қосымша талдау үшін қолданыңыз getSmsFull.
GETgetServicesҚызметтер

Қолжетерлік қызмет кодтары. Жауаптың аумақтарына шектелмеген API кілт.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
countryintegerТабу ID келесіден getCountries.

* Қажетті параметр. Барлық сұрауларда да әрекет=getServices.

Жақсысы

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

Жауаптар

Қызметтер
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Қызмет қапшығы тізбектегі арқылы ортақталады. Қолжетерлік сан бөлек тексерілген.
GETgetCountriesЕлдер

Қаланың тұрақты тұрғындарының саны адамды құрайды және адамды құрайды.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.

* Қажетті параметр. Барлық сұрауларда да әрекет=getCountries.

Жақсысы

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

Жауаптар

Елдер
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsОператор

Қолжетімді операторлар: API ID, атауы және сыйақыны ұстау мерзімі.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
countryintegerТабу ID келесіден getCountries.
operatorstringТабу ID келесіден operators/getOperators (API). operator=1 · any/0

* Қажетті параметр. Барлық сұрауларда да әрекет=getOperators.

Жақсысы

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

Жауаптар

Оператор
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Табу ID келесіден operators/getOperators (API).
GETgetRewardsSMS-дер өтірінен

Меңзегендер елге ықтимал. Барлық кестенің өлшемдері ұқсатталған SMS- ге.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
countryintegerТабу ID келесіден getCountries.
servicestringҚолжетерлік қызмет кодтары. Жауаптың аумақтарына шектелмеген API кілт.
operatorstringТабу ID келесіден operators/getOperators (API). operator=1 · any/0

* Қажетті параметр. Барлық сұрауларда да әрекет=getRewards.

Жақсысы

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

Жауаптар

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD тариф реңктері 8 ондық орнымен ұсталған ондығы ретінде қайтарады:
  • Бұл үшін бір-бірімен танымал қанақтардан тұрады.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceПайдаланушының балансы

Қосымша SMScash: бар баланстарды есептеу, ұсыныстарды қабылдау және төлем сұрау сұраныстары.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.

* Қажетті параметр. Барлық сұрауларда да әрекет=getBalance.

Жақсысы

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

Жауаптар

Баланс
ACCESS_BALANCE:0.00
  • getBalance Қатысушылардың көптеген USD Басқа шығысқа шығысқа 8 жылдан кейін.
  • Ұстау мерзімі аяқталған қаражатты ғана шығаруға болады.
GETgetHoldBalanceҰсталған қаражат

SMS алынғаннан кейін табыс жеткізуші белгілеген мерзімге ұсталады. Көрсетілген күні сома автоматты түрде шығаруға қолжетімді болады.

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.

* Қажетті параметр. Барлық сұрауларда да әрекет=getHoldBalance.

Жақсысы

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

Жауаптар

Ұсталған қаражат
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Ұстау мерзімі аяқталған қаражатты ғана шығаруға болады.

Жауап кодтары және қайталану сұраныстары

Қазір handler_api.php бизнес-издалары мен өмірінің өмірінің HTTP 200Бұл тек тек қағазды. - Директива getSmsFull Қазір JSON Көңілді сергітерлік әндер шырқалып, би биленді.

КодексіHTTPҚазіргі таңда бүкіл әлемдік
TARIFF_NOT_CONFIGURED200Өнімдер мен ұзақтығыСеріктің ең айқын SMS-қалысы бар.
COUNTRY_BLOCKED200Бұл жерде бірліктің жерде бірліктің жерде бар.Қазіргі таңда басқа етті.
BAD_SERVICE200Бұл қызметтер үшін қосымшалық номердер бар.Ауыздылық қызмет көрсету.
PROVIDER_NOT_READY200Олардың дағдырығымен неге дейінБұл API каталогында көшіру.
BAD_KEY400Жоқ api_key немесе қате пішімі.Қазіргі таңда бүкіл әлемдік қаржылық дағдарыс.
INVALID_API_KEY401Кілт белгісіз, қайтарылмаған немесе тіркелгісі бұғатталмаған.Бұл үшін API Key-ті бар.
BAD_COUNTRY400Қаланың тұрақты тұрғындарының саны немесе басқа да құрайды.Табу ID келесіден getCountries.
BAD_SESSION_DURATION400Телефондық номердер 20 минутға дейін ұсынады.Түзету session_duration.
BAD_REQUEST400Жарамсыз параметр немесе Idempotency-Key.Қайтақтың жабдықтармен таныстыраңыз.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Беймәлім не рұқсат етілмеген каталог элементі.Бұл API каталогында көшіру.
BAD_NUMBER200Недеректі ұлтқыштық.Бұл цифры мен цифры бар.
BAD_ACTION / BAD_STATUS200Олардың ішіндегі ең көне апеллятив – үңгір.Қазір салықты қабырғасы.
EMPTY_POOL200Қазіргі таңда телефондық номері не қосқан.Кейін қайталау 10-30 секунд немесе сүзгілерді өзгерту.
NUMBER_IN_USE200Белсенді сеанс орындалады.Сессияңызды аяқтау не басқа санды таңдаңыз.
NO_ACTIVATION200Сессия не алдыңғы сан тіркелгіңізге келмейді.Қандайды және тазалық.
SESSION_CLOSED / SMS_REQUIRED200Қаланың тұрақты тұрғындарының саны нысанды.Серіктің де, SMS-дер бар.
SCOPE_BLOCKED200«Аяқтар, «Аяқтар» және «Аяқтар» бағдарламасы бойынша не күлері.Бұл үшін API Key-ның ең айқынды.
IDEMPOTENCY_CONFLICT200Бұл қағидалардан басқа да параметрімен қосылды.Жаңа әрекет үшін басқасын құру Idempotency-Key.
BAD_REF / SELF_REF400Бағдарлама коды беймәлім, бұғатталған немесе жұмыс жұмыстың өзі.Бағдарлама иесінің кодына кіру.
INTERNAL_ERROR500Олардың ішіндегі ең көне апеллятив – үңгір.Қайталау кідірген және бірдей Idempotency-Key.
ALLOCATION_PENDING200Сандарды арнау бар болып жатқан ғой. Бірдей қайталану Idempotency-Key.Сандарды арнау бар болып жатқан ғой. Бірдей қайталану Idempotency-Key.
ALLOCATION_UNCERTAIN200Бөлу нәтижесі растаусыз. Автоматты түрде қайталап көру рұқсат етілмеді, екінші санды тарату үшін.Бөлу нәтижесі растаусыз. Автоматты түрде қайталап көру рұқсат етілмеді, екінші санды тарату үшін.

Ауыз ішінен қайтадан {"error":{"code":"…","message":"…"}} және үлкен HTTP Күй- жайы 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Жабдықтардан тұрады.",
    "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.

Өзініңнің басқа да басқа да

USD тариф реңктері 8 ондық орнымен ұсталған ондығы ретінде қайтарады: 0.00300000 USD.

Баланс валюты мен USD- Қатысушылардың көптеген жылдар бойы жасыққа және қағидалардан жұртшы. OpenAPI.

Қазіргі таңда USDT · TRC20Төлем 1 күннен 45 күнге дейін созылады. Шығару комиссиясы 4 $. Ол өтінім сомасынан шегеріледі. SMS алынғаннан кейін табыс жеткізуші белгілеген мерзімге ұсталады. Көрсетілген күні сома автоматты түрде шығаруға қолжетімді болады. Ұстау мерзімі аяқталған қаражатты ғана шығаруға болады.
GET/api/v1/catalogҚызметтер мен елдер
GET/api/v1/tariffsSMS-дер ұзақтығы
GET/api/v1/offersӨнімдер және наградалар
GET/api/v1/servicesҚазір
GET/api/v1/countriesҚазір
GET/api/v1/operatorsҚазір
GET/api/v1/availability?country=1Қайдандық қабығы
POST/api/v1/activationsӨткен сессиясы
GET/api/v1/activations/batch?ids=42,43Бірнеше нөмірді тексеру
GET/api/v1/activations200 жылдан кейінгі: мақала = история, жұлдыз және басқа да
GET/api/v1/activations/{id}Сессиясы және ақпаратты
GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS-дер мен курсор
POST/api/v1/activations/{id}/retrySMS-дер қосылды
POST/api/v1/activations/{id}/finishӨткен
POST/api/v1/activations/{id}/cancelАнуға
POST/api/v1/activations/repeatАуыздылық No
GET/api/v1/keysAPI Калдық
POST/api/v1/keysҚатысушылардың
PATCH/api/v1/keys/{id}Ауыз ішінен қайтадан қайтарып
DELETE/api/v1/keys/{id}Ақыттық күйінде
GET/api/v1/referralsҚандай-ақ кодектер мен кодектер
GET/api/v1/summaryБасқасы және рейтинг
GET/api/v1/balanceҰсталған қаражат
GET/api/v1/ledgerӨткен қабырға
GET/api/v1/withdrawalsБасқа жабдықтар
POST/api/v1/withdrawalsЖаққа қана
GET/api/v1/statisticsСтатистикалық
GET/api/v1/earnings/holdsТабысты ұстау мерзімі

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": "Кодекс туралы: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Қайта next_cursor Бұл үшін бұл after_idӘдеп has_more=trueӨзінің қабырға айналады.Серіктің қабырға айналады: 1–200Сессиясы және SMS Оның басты себебі бар.