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

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

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

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

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

REST APIhttps://smscash.org/api/v1
Басқасы API URLhttps://smscash.org/stubs/handler_api.php
Қызмет жыйыТелефон нөмірі, SMS және ықтықтар бар. Кескіндер бар USDT келесіде TRC20. Кеңейтулер арасында 1 және 45 күндер.
Жақсысы · cURL
curl --get 'https://smscash.org/stubs/handler_api.php' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'action=getNumber' \
  --data-urlencode 'service=go' \
  --data-urlencode 'country=86'

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

API

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

cURL · Go · JS · Python
Басқасы API URLhttps://smscash.org/stubs/handler_api.php
cURL
curl --max-time 15 --fail-with-body 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

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

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

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

Қызметті мен елді таңдаңыз. 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)

Қазіргі таңда
handler_api.php
GET /stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86

Автоматты таңдау: қолжетімді оператор кездейсоқ таңдалады.

REST
ACCESS_NUMBER: session ID · phone number
service + country · session_duration: 20
ref: software owner code (optional)
operator: public ID (e.g. 1) or comma-separated IDs (e.g. "1,3")
optional · omitted/any/0: random eligible provider
country: integer · service: string · SMS code: string

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

Бірнеше нөмірді тексеру
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": 10
}
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';

const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);

const messages = await api.sms(42, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([42]);
const held = await api.holdBalance();
console.log(held); // Exact USD string
Python 3.9+
import os
from smscash import SmScash, SmScashError

api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])

messages = api.sms(42, after_id=0)
print(messages['sms'])
statuses = api.batch([42])
held = api.hold_balance()
print(held) # Exact USD string
SDK
me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
setStatus(id, "cancel") / set_status(id, "cancel")
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'
Жауаптар
{
  "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, e.g. 1,3); 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.
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-дер 10 секундта дейін аударылады.

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

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

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

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

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

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

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). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0
session_durationintegerҚазіргі таңда 20 минут қанағаттанды. 20 минут қанағаттанды.
with_operatorinteger1 жауапқа оператордың ID-сін қосады; 0 немесе параметр көрсетілмесе, үш бөлік қайтарылады.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

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

Жақсысы

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

Жауаптар

Қатысушылардың
ACCESS_NUMBER:42:380670000000:1
Жұмымымы қабығы
EMPTY_POOL
  • Автоматты таңдау: қолжетімді оператор кездейсоқ таңдалады.
  • Ұяшықсыз ел - 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'

Жауаптар

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

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

параметрі

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

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

Жақсысы

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go'

Жауаптар

Өткен сессиясы
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": "operator=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 кілт.

Қазір

Баспа…

JSON ↗

Қызмет қапшығы тізбектегі арқылы ортақталады. Қолжетерлік сан бөлек тексерілген.

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

параметрі

параметрӨткенОғанды
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Елдер

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

Қазір

Баспа…

JSON ↗

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

параметрі

параметрӨткенОғанды
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). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · 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": "operator=1",
    "earnings_hold_days": 45
  }
}
  • Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3.
GETgetRewardsSMS-дер өтірінен

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

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
countryintegerТабу ID келесіден getCountries.
servicestringҚолжетерлік қызмет кодтары. Жауаптың аумақтарына шектелмеген API кілт.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · 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)
GETgetTopCountriesByServiceТоп стран по сервису

До 10 стран с лучшей доставкой смс кодов за последние 24 часа

параметрі

параметрӨткенОғанды
api_key*stringПайдаланушының жеке API кілті.
service*stringКод сервиса из getServices.

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

Жақсысы

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

Жауаптар

Структура ответа

Ключ в примереОғандыҚазір
["12"], ["36"]Қазір ID
Первый, внешний уровень JSON. Каждая запись объединяет операторов одной страны.
getCountries
["12"]["1"], ["12"]["3"]ID оператора
Второй уровень JSON, внутри страны. Это публичный ID оператора (поставщика), который передаётся в параметре operator.
getOperators
JSON
{
  "12": {
    "1": {
      "reward": 0.012,
      "count": 542
    },
    "3": {
      "reward": 0.014,
      "count": 301
    }
  },
  "36": {
    "1": {
      "reward": 0.011,
      "count": 190
    }
  }
}
{}
{}
  • В примере ["12"]["1"] — данные оператора 1 в стране 12. ID стран берутся из getCountries, ID операторов — из getOperators.
  • reward — действующее личное вознаграждение в USD, JSON-число. count — количество выданных номеров за последние 24 часа, включая сессии без кода.
  • Рейтинг рассчитывается как все полученные непустые коды, делённые на все выдачи номеров за последние 24 часа для выбранного сервиса.
  • Повторные непустые коды увеличивают числитель; конверсия может превышать 100%. Начальные нули сохраняются.
  • Суточная статистика сервиса кэшируется на 10 минут. Тарифы и ограничения ключа проверяются при каждом запросе. Момент среза — в заголовке X-Statistics-As-Of.
  • Нет данных или доступных связок — пустой объект {}. Страны с выдачами и нулём кодов имеют нулевую конверсию. Порядок ключей JSON не задаёт места в рейтинге.
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Жабдықтардан тұрады.Қайтақтың жабдықтармен таныстыраңыз.
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-ның ең айқынды.
INTERNAL_ERROR500Олардың ішіндегі ең көне апеллятив – үңгір.Байланыс және қолдау · X-Request-ID
ALLOCATION_PENDING200ЖүктеуgetActiveActivations · getStatus
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 Оның басты себебі бар.