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 Key шилдэг

Танд тодорхой үйлчлэл, орнуудыг болон хангалуудыг зогсож чадна. Хоосон тогтолцооны бүх сонгохыг болгодог.

JSON
{
  "label": "програм хангамж",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Энэ нь нэр, полиц бүрэн өөрчлөгдсөн. тайны зөвхөн бий болгож байгаа үед үзсэн байна.

10% нь агуулсан. 5% + 5% програм хангамж код.

Хэрэв та дугаар авах үед, please provide ref програм хангамж нь хоорон. Заяг нь пользователь нь тавтай. Код "Рэфер" хэсэгт, GET /api/v1/referrals → software_ref.

ҮнэгүйҮнэгүйПрограм хангамж
Нэхмэл ReF10%—
ReF нь5%5%
ReF нь, ямар ч Referrer—5%

Платфорд хэрэглэгчид зардал нь татаж авахгүй бол бонус зардал. програм хангамж авлагачид болон холбоо барихчид нь нэг хүн байж болно. хэрэглэгчид нь өөрийн код ашиглаж болно.

Бүртгүүр нь тохиромжтой байна; чэмжлэгдсэн SMS Аж retry Энэ нь өөрчилжгүй. Pass ref шинэ шинэ шинэ шинэ сеанс нь. Таригийн тооцоо, хэрэглэгчид нь зардал USD 0.003 Дараа нь USD 0.00015 нэг нь програм хангамж, холбоо барих. Бүх бонус нь USD 0.00030.

API Үнэгүй

11 XVBC-т стиль методологийг плюс таны SMScash баланс.

GETgetNumberҮнэгүй дугаар

Энэ нь сеанс үүсгэх, хэрэглэгчид нь хэрэглэгддэг дугаар резервируулдаг. Үнэгүй тав, referral хэрэглэгчид нь арилжааны дээр фиксируулсан байна; Үнэгүй тав нь кодтэй 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'

Ажлын

Үнэгүй дугаар
EMPTY_POOL
  • Автомат сонголт: боломжтой оператороос санамсаргүй сонгоно.
  • Баашгүй нунтаг улс нь EMPTY_POOL-д санал болгож байна; хавтан улс формат нь BAD_COUNTRY юм.
  • Хэвийн нь хялбар ашиглаж байна: Энэ нь хялбар нь хялбар нь SESSION_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 suffix нь тодорхой операторгүй сонголт юм.
  • Таасан нь нийлүүлэгчдийн агуулсан багийн талаар байна. сонгодог канал нь тоо татаж авах үед шалгаж байна.
GETgetStatusЭнэ нь хамгийн сүүлийн үеийн код

Энэ нь сессийн статус, хамгийн сүүлийн үеийн SMS код нь хязгааргүй хэрэглээ. код дээр хамгийн их нурууд хадгалах.

Үнэгүй

АжлынХэвлэгчҮнэгүй
api_key*stringХэрэглэгчийн хувийн API түлхүүр.
id*integerТаны сеанс ID, дугаар зардал үед хүлээн авсан.

* Нууцны параметр. Бүх хэрэглээнд бас үйл явц =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
Үнэгүй
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Таны сеанс ID, дугаар зардал үед хүлээн авсан.
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
  • Retry дараагийн код нь эхний 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
  • Эхлээд, таны одоогийн сеанс дуусгах эсвэл анхаарал. Энэ тоо нь усан байгаа бол, re-issuance нь хийж чадна.
  • Шинэ сеанс шинэ ID болон одоогийн тариф авах. Дараа нь SMS нь татаж авахгүй. ref нь шинэ тохируулах байна.
  • SMScash энэ тоогийн түүхээс л тоо дахин давтах боломжтой. Үүнийг үндэстнийг тоог тогтоож тоглож байна.
  • Хэвийн нь хялбар ашиглаж байна: Энэ нь хялбар нь хялбар нь SESSION_CLOSED-ийн тавтай авч, бусад дугаар зардалгүй.
GETgetSmsFullSMS нь JSON

Бүх мэдээлэл ID, அனுப்பгч, код, текст, улс, үйлчилгээ, нийлүүлэгч мэдээлэл нь структурирован түүх.

Үнэгүй

АжлынХэвлэгчҮнэгүй
api_key*stringХэрэглэгчийн хувийн API түлхүүр.
id*integerТаны сеанс ID, дугаар зардал үед хүлээн авсан.

* Нууцны параметр. Бүх хэрэглээнд бас үйл явц =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Таны сеанс ID, дугаар зардал үед хүлээн авсан.

* Нууцны параметр. Бүх хэрэглээнд бас үйл явц =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
  • Зөвлөгөө формат: цаг код, текст. олон Зөвлөгөө нь нэг колоны дагуу харах.
  • 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"]Эдүүлбэр
Первый, внешний уровень 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
  • Зөвхөн саатуулах хугацаа дууссан мөнгийг авах боломжтой.

Reply Код болон Reply Захид нь

Та handler_api.php бизнес үр дүн нь нь HTTP 200 нь идэвхж байна. Торонтоор текстыг үзээрэй. Directions болон getSmsFull JSON нь үр дүнтэй байна; Үзээ нь үргэлж текст юм.

КодHTTPДараа нь шагнал
TARIFF_NOT_CONFIGURED200Үнэгүй үнэтэй байхгүйБэлэглэлт нь SMS-ийн урамшуулал дээр тохируулах үед эхлэх болно.
COUNTRY_BLOCKED200Энэ улс нь нунтаг нь бөөний байна.Дараа нь улс сонгох.
BAD_SERVICE200Энэ үйлчилгээ нь нунтаг нь блогт байна.Энэ нь бусад үйлчилгээг сонгох.
PROVIDER_NOT_READY200Бэлэглэл нь цаг хугацааны байдагAPI каталогүүд нь шинэчлэх.
BAD_KEY400Үгүй api_key эсвэл буруу хэлбэр.Загвар дээр нь тавтай үзэх.
INVALID_API_KEY401Хэвлэгч нь мэдэгдсэн, отклонигүй, эсвэл нь акаунт нь уртгүй байна.Энэ нь API-ийн тавтай буцааж.
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Зөвхөн мэдэгдсэн орчим, ID, эсвэл үйл ажиллагаа.Энэ нь тохиргоо үзнэ үү.
EMPTY_POOL200Одоо цогцооны тоогүй байна.10-30 секунд дараа нь дахин мэдэгдэх эсвэл филт тэрэгний өөрчлөх.
NUMBER_IN_USE200Ажлын сеанс нь тодорхой тоо нь зай.Таны сеанс дуусгах эсвэл бусад тоо сонгох.
NO_ACTIVATION200Сесийн эсвэл Өмнөх дугаар таны λογαριασтын хувьд биш юм.ID болон тавтай шалгаж.
SESSION_CLOSED / SMS_REQUIRED200Дараа нь улс орчим нь одоо ямар ч байдаг.SMS-ийн ус, хэрэглээний талаар үзэх.
SCOPE_BLOCKED200үйлчилгээ, улс, эсвэл хангамж нь тавтай нь эрхгүй байна.API тоглоомын хэмжээг шилжүүл
INTERNAL_ERROR500Хэвлэгч / сервер нь хялбар.Холбоо барих ба тусламж · X-Request-ID
ALLOCATION_PENDING200АжлынgetActiveActivations · getStatus
ALLOCATION_UNCERTAIN200Эдүүлбэр нь тодорхойлолтгүй байна. Автомат утас нь хоёр дахь тоо утасгүй байх нь утасгүй байна.Эдүүлбэр нь тодорхойлолтгүй байна. Автомат утас нь хоёр дахь тоо утасгүй байх нь утасгүй байна.

REST нь объект нь татаж авах {"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/activationsДараа нь 200 сеанс: scope=history, чанарын эсвэл бүх
GET/api/v1/activations/{id}Сезон болон мэдээлэл
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Шинэ SMS курсор нь
POST/api/v1/activations/{id}/retrySMS нь үзэх
POST/api/v1/activations/{id}/finishҮнэгүй
POST/api/v1/activations/{id}/cancelАжлын
POST/api/v1/activations/repeatАжлын дугаар
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Үнэгүй 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 тэнцүү эзэнт хангалттай байна.