эхлэх

API-ийн мэдээлэл

Бунт, мэдээ, зардал, таны апп дээр直接.

GET

Эхний ч санал

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

Үнэгүйүйлчилгээ APIГэргийн APIАж үйлдвэрийн operatorПрограм хангамж хоолой код refIdempotency-Key

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

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
  "time"
)

func main() {
  payload := []byte("{\"service\":\"go\",\"country\":86}")
  req, err := http.NewRequest("POST", "https://smscash.org/api/v1/activations", bytes.NewReader(payload))
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer " + os.Getenv("SMSCASH_API_KEY"))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Idempotency-Key", "request-unique-001")
  client := &http.Client{Timeout: 15 * time.Second, CheckRedirect: func(_ *http.Request, _ []*http.Request) error { return http.ErrUseLastResponse }}
  res, err := client.Do(req)
  if err != nil { panic(err) } // Keep the same operation key after a network error.
  defer res.Body.Close()
  body, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  if res.StatusCode >= 300 {
    fmt.Fprintf(os.Stderr, "HTTP %d, request_id=%s\n%s\n", res.StatusCode, res.Header.Get("X-Request-ID"), body)
    os.Exit(1)
  }
  fmt.Println(string(body))
}

JavaScript

// Node.js 18+: set SMSCASH_API_KEY in your environment.
const response = await fetch("https://smscash.org/api/v1/activations", {
  method: "POST",
  headers: {
    Authorization: 'Bearer ' + process.env.SMSCASH_API_KEY,
    'Content-Type': 'application/json',
    'Idempotency-Key': "request-unique-001",
  },
  body: JSON.stringify({
  "service": "go",
  "country": 86
}),
  signal: AbortSignal.timeout(15000),
  redirect: 'error',
});
const result = await response.json();
if (!response.ok) {
  const error = result.error || {};
  console.error(response.status, error.code, error.hint, error.request_id);
  throw new Error(error.message || 'API error');
}
console.log(result);
// SMS codes are strings: keep leading zeros. Never retry writes automatically.

Python

import json
import os
import urllib.error
import urllib.request

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

headers = {
    'Authorization': 'Bearer ' + os.environ['SMSCASH_API_KEY'],
    'Content-Type': 'application/json',
    'Idempotency-Key': "request-unique-001",
}
request = urllib.request.Request(
    "https://smscash.org/api/v1/activations",
    headers=headers,
    data="{\"service\":\"go\",\"country\":86}".encode('utf-8'),
    method="POST",
)
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=15) as response:
        result = json.load(response)
    print(result)
except urllib.error.HTTPError as error:
    details = json.load(error).get('error', {})
    print(error.code, details.get('code'), details.get('hint'), details.get('request_id'))
    raise
# No automatic retries; SMS codes remain strings.

API Хэвлэгч

Түлхүүр хадгалагдахгүй. Энэ шалгалт дугаар олгохгүй.

Шинэ интеграцийн хувьд

Үйлчилгээ ба улс орнууд

Үнэгүй үйлчилгээ, улс орнууд сонгох. 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
}

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 ↓Python ↓

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 Энэ нь сонголт юм, гэхдээ handler_api.php-д санал болгож байна. сүлжээний хүсэлтийг уртсан үед тавтай ашиглаж; шинэ үйл ажиллагаа нь шинэ тавтай ашиглаж.

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.

Үнэгүй	Үнэгүй	Програм хангамж
Нэхмэл ReF	10%	—
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.
`operator`	string	Өчүүх ID Цагаан operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	Суулгах нь 20 минут орж байна. 20 хуваалцах юм уу энэ параметрийг орхих юм.
`with_operator`	integer	1 нь хариунд операторын ID-г нэмнэ; 0 эсвэл параметргүй үед гурван хэсэг буцаана.
`ref`	string	Програм хангамж хоорондын публичны код: 5% нь, 5% нь гост. Нэхмэл ref - 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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1", nil)
  if err != nil { panic(err) }
  req.Header.Set("Idempotency-Key", "request-unique-001")
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1", {
  headers: {"Idempotency-Key": "request-unique-001"}
});
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1",
    headers={"Idempotency-Key": "request-unique-001"},
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

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

EMPTY_POOL

Автомат сонголт: сүүлийн цагт, дараа нь 24 цагт хамгийн олон кодтой оператор. Дугааргүй бол дараагийн оператор.
Хариул Idempotency-Key: адилхан тоглоомтай адил шаардлага өмнөх сессиг буцаж ирнэ. Параметрүүдийг өөрчлөх IDEMPOTENCY_CONFLICT.
Баашгүй нунтаг улс нь 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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86",
    timeout=15,
)
print(response.status_code, response.json())

Ажлын

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

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42",
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

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`*	integer	3 — дараагийн код нь сеанс продласангүй чадахгүй; 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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3", nil)
  if err != nil { panic(err) }
  req.Header.Set("Idempotency-Key", "request-unique-001")
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3", {
  headers: {"Idempotency-Key": "request-unique-001"}
});
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3",
    headers={"Idempotency-Key": "request-unique-001"},
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

SMS нь үзэх

ACCESS_RETRY_GET

Бүтээгдэхүүний

ACCESS_ACTIVATION

Ажлын

ACCESS_CANCEL

Retry дараагийн код нь эхний 20 минут дотор чадахгүй байна. Үнэгүй хугацаа, давхар хугацаа нь өөрчлөн биш юм.
Бяцхан байдал=3 хэрэглэх Idempotency-Key: гуйсан шинэ кодийг дахин давтах болно. SMS мөнх амьдардаг.
Аж үйлдвэрийн төлбөр нь одоогийн зардалтай зардал нь татаж авахгүй.
SMS код нь зөвхөн дугаар нь түүх дээр хадгалах. кодгүй, ачаагүй, ачаагүй дугаар нь татаж авах.

GETgetRepeatNumberДахиад адил тоо тоглох нь

Таны түүх нь тодорхой дугаар нь шинэ сеанс эхлэх. Та нэг улс дээр өөр өөр өөр хэрэглэгчийн үйлчилгээ сонгох болно.

Үнэгүй

Ажлын	Хэвлэгч	Үнэгүй
`api_key`*	string	Хэрэглэгчийн хувийн API түлхүүр.
`number`*	string	Таны давхар дугаар. зөвхөн тоо болон сонголт нь +-ийн санал болгож байна.
`service`*	string	Үнэгүй үйлчилгээ код. Эдгээр нь API-ийн тоног төхөөрөмж дээр ограничено.
`session_duration`	integer	Суулгах нь 20 минут орж байна. 20 хуваалцах юм уу энэ параметрийг орхих юм.
`with_operator`	integer	1 нь хариунд операторын ID-г нэмнэ; 0 эсвэл параметргүй үед гурван хэсэг буцаана.
`ref`	string	Програм хангамж хоорондын публичны код: 5% нь, 5% нь гост. Нэхмэл ref - 10% нь гост.
`operator`	string	Өчүүх 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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go", nil)
  if err != nil { panic(err) }
  req.Header.Set("Idempotency-Key", "request-unique-001")
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go", {
  headers: {"Idempotency-Key": "request-unique-001"}
});
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go",
    headers={"Idempotency-Key": "request-unique-001"},
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

шинэ сеанс

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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42",
    timeout=15,
)
print(response.status_code, response.json())

Ажлын

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	Таны сеанс ID, дугаар зардал үед хүлээн авсан.

* Нууцны параметр. Бүх хэрэглээнд бас үйл явц =getSms.

Загварын зураг

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42",
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

Үнэгүй

STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234

Ажлын

STATUS_WAIT_CODE

Ажлын, эсвэл дуусгах

STATUS_CANCEL

Зөвлөгөө формат: цаг код, текст. олон Зөвлөгөө нь нэг колоны дагуу харах.
SMS нь сам нь колоны болон утас баглаа боодол болно. Та аюулгүй парсинг нь getSmsFull ашиглаж.

GETgetServicesҮйлчилгээнүүд

Үнэгүй үйлчилгээ код. Эдгээр нь API-ийн тоног төхөөрөмж дээр ограничено.

Үнэгүй

Ажлын	Хэвлэгч	Үнэгүй
`api_key`*	string	Хэрэглэгчийн хувийн API түлхүүр.
`country`	integer	Өчүүх ID Цагаан getCountries.

* Нууцны параметр. Бүх хэрэглээнд бас үйл явц =getServices.

Загварын зураг

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.json())

Ажлын

Үйлчилгээнүүд

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.json())

Ажлын

Улсууд

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

GETgetOperatorsАж үйлдвэрийн

Боломжтой операторууд: API ID, нэр болон урамшууллыг түгжих хугацаа.

Үнэгүй

Ажлын	Хэвлэгч	Үнэгүй
`api_key`*	string	Хэрэглэгчийн хувийн API түлхүүр.
`country`	integer	Өчүүх ID Цагаан getCountries.
`operator`	string	Өчүүх 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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.json())

Ажлын

Аж үйлдвэрийн

{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}

Өчүүх ID Цагаан operators/getOperators (API).

GETgetRewardsSMS нь зардал

Тавтай үнэ нь улс дээр суурилсан. Бүх тавтай суулгах нь үнэгүй SMS-ийн суулгах.

Үнэгүй

Ажлын	Хэвлэгч	Үнэгүй
`api_key`*	string	Хэрэглэгчийн хувийн API түлхүүр.
`country`	integer	Өчүүх ID Цагаан getCountries.
`service`	string	Үнэгүй үйлчилгээ код. Эдгээр нь API-ийн тоног төхөөрөмж дээр ограничено.
`operator`	string	Өчүүх 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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi",
    timeout=15,
)
print(response.status_code, response.json())

Ажлын

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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

Үлдэгдэл

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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.text)

Ажлын

Түр саатуулсан мөнгө

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Зөвхөн саатуулах хугацаа дууссан мөнгийг авах боломжтой.

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

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

Код	HTTP	Дараа нь шагнал
`TARIFF_NOT_CONFIGURED`	200	Үнэгүй үнэтэй байхгүйБэлэглэлт нь SMS-ийн урамшуулал дээр тохируулах үед эхлэх болно.
`COUNTRY_BLOCKED`	200	Энэ улс нь нунтаг нь бөөний байна.Дараа нь улс сонгох.
`BAD_SERVICE`	200	Энэ үйлчилгээ нь нунтаг нь блогт байна.Энэ нь бусад үйлчилгээг сонгох.
`PROVIDER_NOT_READY`	200	Бэлэглэл нь цаг хугацааны байдагAPI каталогүүд нь шинэчлэх.
`BAD_KEY`	400	Үгүй api_key эсвэл буруу хэлбэр.Загвар дээр нь тавтай үзэх.
`INVALID_API_KEY`	401	Хэвлэгч нь мэдэгдсэн, отклонигүй, эсвэл нь акаунт нь уртгүй байна.Энэ нь API-ийн тавтай буцааж.
`BAD_COUNTRY`	400	Энэ нь улс улс нь хувилбаргүй байна эсвэл ямар ч хувилбаргүй байна.Өчүүх ID Цагаан getCountries.
`BAD_SESSION_DURATION`	400	Торонтоор дугаар 20 минут нь энд байна.Зөвлөл session_duration.
`BAD_REQUEST`	400	Буруу параметр Idempotency-Key.Таны хүсэл нь зөв хийх.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Зөвхөн мэдэгдсэн эсвэл утасгүй каталог элемент.API каталогүүд нь шинэчлэх.
`BAD_NUMBER`	200	Хэвлэхгүй дугаар формат.Энэ нь цифр дээр тоо.
`BAD_ACTION / BAD_STATUS`	200	Зөвхөн мэдэгдсэн орчим, ID, эсвэл үйл ажиллагаа.Энэ нь тохиргоо үзнэ үү.
`EMPTY_POOL`	200	Одоо цогцооны тоогүй байна.10-30 секунд дараа нь дахин мэдэгдэх эсвэл филт тэрэгний өөрчлөх.
`NUMBER_IN_USE`	200	Ажлын сеанс нь тодорхой тоо нь зай.Таны сеанс дуусгах эсвэл бусад тоо сонгох.
`NO_ACTIVATION`	200	Сесийн эсвэл Өмнөх дугаар таны λογαριασтын хувьд биш юм.ID болон тавтай шалгаж.
`SESSION_CLOSED / SMS_REQUIRED`	200	Дараа нь улс орчим нь одоо ямар ч байдаг.SMS-ийн ус, хэрэглээний талаар үзэх.
`SCOPE_BLOCKED`	200	үйлчилгээ, улс, эсвэл хангамж нь тавтай нь эрхгүй байна.API тоглоомын хэмжээг шилжүүл
`IDEMPOTENCY_CONFLICT`	200	Энэ нь анхаарлаа нь бусад параметрийн нь одоогийн холбоотой байна.Шинэ операцияны төлөө өөр нэгийг бүтээх Idempotency-Key.
`BAD_REF / SELF_REF`	400	Програм хангамж код нь мэдэгдсэн, хязгааргүй, эсвэл хэрэглэгчид нь нэг юм.Програм хангамж хоолой код дээр татаж авах.
`INTERNAL_ERROR`	500	Хэвлэгч / сервер нь хялбар.Завсарлагатай дахин давтах Idempotency-Key.
`ALLOCATION_PENDING`	200	Тоо тоглохыг зогсоож байна. Тэгэхээр тэнцүүгээр давтах Idempotency-Key.Тоо тоглохыг зогсоож байна. Тэгэхээр тэнцүүгээр давтах Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	Эдүүлбэр нь тодорхойлолтгүй байна. Автомат утас нь хоёр дахь тоо утасгүй байх нь утасгүй байна.Эдүүлбэр нь тодорхойлолтгүй байна. Автомат утас нь хоёр дахь тоо утасгүй байх нь утасгүй байна.

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 тэнцүү эзэнт хангалттай байна.