Grand SMS
API-ի մանրամասներ

API-ի մանրամասներ

Սկսեք մեկ հարցով

14 · API ԿառավարությունREST + handler_api.phpJSON / plain text · Bearer

Create an API key in your dashboard, get a number and check for messages every 10 seconds. Վճարումը վարկավորվում է, երբ SMS-ը կոտրված է, կրկին կարդալը չի վնասում ձեր բուժումը:

REST APIhttps://smscash.org/api/v1
Հիմնական հոդված՝ API-ի URL-ըhttps://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'

Alternative compatible interface address: /handler_api.php. Հիմնական REST- ի միավորները շարունակվում են աշխատել:

API

Հարցումների կառուցիչ

cURL · Go · JS · Python
Հիմնական հոդված՝ API-ի URL-ըhttps://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-ի URL-ըhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Հիմնական հոդված՝ API-ի URL-ըhttps://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: Հիմնական հոդված՝ Header Authorization: Bearer YOUR_API_KEY. Համագործակցական սարքերի համար: Parameters Վիքիպահեստում api_key եւ actionՕգտագործեք HTTPS- ը

Եթե ցանկանում եք կառավարել API- ի գաղտնիքը, ապա դուք պետք է գրեք ձեր հաշվարկը:

∞խնդրանքներ/մինը յուրաքանչյուր հաշվարկ
∞Հիմնական հոդված՝ Simultaneous Sessions

API- ի խնդրման հաճախությունը եւ զանգահարվածների քանակը անպայման են. օրական կամ ժամական արժեքներ չունենա.

Մեկ քայլը 20 րոպե է, SMS-ը 10 րոպեից մեկ անգամ է, եւ դուք կարող եք անմիջապես փոխել:

API Key Scope Վիքիպահեստում

Դուք կարող եք թույլ տալ մի գաղտնիքը, որ որոշակի աշխատանքի, երկիրների եւ վաճառողների. թաքնված գաղտնիքը թույլ է տալիս բոլոր օգտակար հնարավորությունները.

JSON
{
  "label": "Իմ սարքերի",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Անունը եւ գրառումը փոխվում են ամբողջությամբ. սա միայն ցույց է տալիս, երբ ստեղծվում է.

10%-ը ամբողջական. 5% + 5%-ը սարքավորման կոդով:

Եթե դուք ստորագրում եք մի քայլ, խնդրում եմ, տրամադրեք ref Հրատարակիչը. խնդրը հաստատվում է օգտագործողի գաղտնիքը. կոդը գտնվում է «Հրատարակիչներ» հոդվածում եւ GET /api/v1/referrals → software_ref.

խնդրողությունՀաղթողՀիմնական հոդված՝ Software
Ոչ թե REF10%—
Հիմնական հոդված՝ Ref5%5%
Հիմնական հոդված՝ Ref, No Referrer—5%

Աշխատանքային համակարգիչը վճարում է գումարը առանց օգտագործողի գումարը կորցնելու. Աշխատանքային համակարգիչի տունն ու ուղարկողը կարող են լինել նույն մարդը. Աշխատանքային օգտագործողը չի կարող օգտագործել իր գումարը:

Ժամանակները որոշվում են, երբ մի հանդիպումը ստեղծվում է: կարդալ SMS եւ վերադառնալը չեն փոխում նրանց. Pass 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- ը:
  • Հետաքրքիր սենյակի գաղտնիքը օգտագործվում է: Հետաքրքիր սենյակը վերադարձնում է 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
  • Վերադառնալը սպասում է հաջորդ կոդը 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
  • Առաջինը, ավարտեք կամ կանգնեք ձեր հիմնական նիստը. Եթե հաշվետվությունը զբաղված է, կրկին կանգնածը չի կատարվում:
  • Նոր սենյակը ստանում է նոր 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 - active, 6 - completed, 8 - cancelled կամ expired. 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 ↗

Աշխատանքային գրասենյակը կիսվում է բոլոր հաճախորդների միջեւ. Number availability is checked separately.

Դուք կարող եք թույլ տալ մի գաղտնիքը, որ որոշակի աշխատանքի, երկիրների եւ վաճառողների. թաքնված գաղտնիքը թույլ է տալիս բոլոր օգտակար հնարավորությունները.

Մեկնաբանություններ

ՄեկնաբանությունՄարդիկԿրթություն
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"
  }
}
  • Աշխատանքային գրասենյակը կիսվում է բոլոր հաճախորդների միջեւ. Number availability is checked separately.
GETgetCountriesԵրկրներ

IDs, անունները եւ զանգահարման կոդերը երկիրների համար ընտրված քայլում.

Գրադարան

Հրատարակչություն…

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 նույնացուցիչ, անուն և պարգևի պահման ժամկետ։

Մեկնաբանություններ

ՄեկնաբանությունՄարդիկԿրթություն
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Օգտագործողի մնացորդը

Addition SMScash: available balance taking into account accruals, referral bonuses եւ վճարման խնդրանքները.

Մեկնաբանություններ

ՄեկնաբանությունՄարդիկԿրթություն
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Անհավանական սարքավորումը, ID կամ գործունեությունը.Կհանդիպեք պայմանագրերը.
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. Request and response schemes are available in 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, waiting or all
GET/api/v1/activations/{id}Հանդիպում եւ հաղորդագրություն
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Նոր SMS-ը կոտրված է
POST/api/v1/activations/{id}/retryՀաղթանակներ SMS-ի համար
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}Հրատարակված է Key
GET/api/v1/referralsReferral Code եւ գումարը
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 Կարելի է ասել միայն ունկնդիրը ։