Սկսելու համար

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

Մեկնաբանություններ, հաղորդագրություններ եւ գումարները, անմիջապես ձեր հավելվածից.

GET

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

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

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

REST APIhttps://smscash.org/api/v1

Հիմնական հոդված՝ API-ի URL-ըhttps://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}'

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

REST API

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

cURL · Go · JS · Python

խնդրողությունԱշխատանք APIերկիրը APIՀաճախորդ operatorՀրատարակիչը ReF CodeIdempotency-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 Key Հաղթանակ

Բանալին չի պահպանվում։ Այս ստուգումը համարներ չի հատկացնում։

Նոր ինտերգիաների համար

Ծառայություններ և երկրներ

Աշխատանքը եւ երկիրը ընտրեք. SMS-ի միջոցով վճարումը կպատմվի երկիրը:

REST

GET /api/v1/catalog?service=go&country=86&page=1&page_size=100
Authorization: Bearer YOUR_API_KEY

JSON

{
  "rows": [
    {
      "offer_id": 42,
      "service": "go",
      "service_name": "Google",
      "country_id": 86,
      "country_name": "Italy",
      "provider_id": 1,
      "operator": 1,
      "provider_name": "Operator 1",
      "reward": "0.00300000",
      "currency": "USD",
      "accounting_precision": 8,
      "earnings_hold_days": 45
    }
  ],
  "page": 1,
  "page_size": 100,
  "total": 1,
  "pages": 1,
  "has_more": false,
  "accounting_precision": 8
}

service · country · operator · q · page · page_size (1–100)

Գնեք մի քանակ

REST

POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

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

Ավտոմատ ընտրություն՝ ամենաշատ կոդերը վերջին ժամում, ապա՝ 24 ժամում։ Համարներ չկան՝ հաջորդ օպերատորը։

REST

201: new session · 200: replay of the same operation
service + country OR offer_id · duration_minutes: 20
ref: software owner code (optional)
operator: public ID (e.g. 1 for Operator 1), optional · any/0: automatic
country: integer · service: string · SMS code: string

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

Ստուգել մի քանի համար

REST

GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY

JSON

{
  "rows": [
    {
      "id": 42,
      "found": true,
      "phone": "12025550123",
      "status": "received",
      "service": "go",
      "country_id": 86,
      "provider_id": 1,
      "operator": 1,
      "expires_at": "2026-10-10T12:15:00Z",
      "sms_count": 1,
      "code": "001234",
      "last_sms": {
        "id": 101,
        "code": "001234",
        "sender": "Service",
        "text": "Code: 001234",
        "received_at": "2026-10-10T12:01:00Z"
      }
    },
    {
      "id": 43,
      "found": false,
      "error": {
        "code": "NO_ACTIVATION",
        "message": "Session not found."
      }
    }
  ],
  "as_of": "2026-10-10T12:01:00Z",
  "poll_interval_seconds": 20
}

REST

ids: 1–100 positive session IDs, separated by commas
Input order preserved · duplicates removed
Foreign, unavailable or out-of-scope IDs: found=false
Read only · no supplier requests · last_sms is the latest message

Մնացորդ · Պահված գումար

REST

GET /api/v1/balance
Authorization: Bearer YOUR_API_KEY

JSON

{
  "currency": "USD",
  "accounting_precision": 8,
  "balance": "12.00000000",
  "held_balance": "34.50000001",
  "balance_minor": "1200000000",
  "held_minor": "3450000001",
  "as_of": "2026-10-12T20:00:00Z",
  "next_release_at": "2026-11-26T20:00:00Z"
}

balance — Հասանելի; held_balance — Պահված գումար. USD · 8

Կարելի է դուրս բերել միայն այն գումարները, որոնց պահման ժամկետն ավարտվել է։

Պատրաստի հաճախորդ ծրագրեր

JavaScript / Node.js ↓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-ի 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' \
  -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: Հիմնական հոդված՝ Header Authorization: Bearer YOUR_API_KEY. Համագործակցական սարքերի համար: Parameters Վիքիպահեստում api_key եւ actionՕգտագործեք HTTPS- ը

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

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

∞Հիմնական հոդված՝ Simultaneous Sessions

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

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

Մինչեւ մյուսը, միակ Idempotency-Key Անհրաժեշտ է հաշվետվության համար, կրկին հաշվետվության համար, վերադառնալու եւ վճարման հարցերի համար. դա ընտրական է, բայց առաջարկվում է handler_api.php- ում. կրկին օգտագործեք գաղտնիքը, երբ վերադառնալու է մի ցանցի հարցը: օգտագործեք նոր գաղտնիքը նոր գործառույթի համար:

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
Ոչ թե REF	10%	—
Հիմնական հոդված՝ Ref	5%	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.
`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)

պատասխաններ

Հրատարակված հաշվետվություն

ACCESS_NUMBER:42:380670000000:1

Ոչ մի մանրամասներ չունենա

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

Վերադառնալը սպասում է հաջորդ կոդը 20 րոպեում. թողարկման եւ ավարտի ժամանակները չեն փոխվում:
Status=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

Առաջինը, ավարտեք կամ կանգնեք ձեր հիմնական նիստը. Եթե հաշվետվությունը զբաղված է, կրկին կանգնածը չի կատարվում:
Նոր սենյակը ստանում է նոր 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 - 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'

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

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

GETgetCountriesԵրկրներ

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

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

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

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

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

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'

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
Կարելի է դուրս բերել միայն այն գումարները, որոնց պահման ժամկետն ավարտվել է։

Կրթություն եւ կրկնության հարցեր

Ամեն handler_api.php բիզնեսի արդյունքները սովորաբար գալիս են HTTP 200. փորձիր մարմնի տեքստը. պարբերագրեր եւ 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 Key- ը.
`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	Հաջորդ հոդվածըՀայաստանն ու Ձեր հաշվետվությունը չպետք է լինեն Ձեր հաշվետվության մեջ։Կրթության եւ քարտեզի քարտեզը.
`SESSION_CLOSED / SMS_REQUIRED`	200	Աշխարհի փոխարենը այժմ դժվար չէ։Կրթության պայմանը եւ SMS-ի օգտագործման հնարավորություն.
`SCOPE_BLOCKED`	200	Աշխատանքը, երկիրը կամ վաճառողը չի թույլ է տալիս գլուխը.Հիմնական հոդված՝ API Key-ի փոփոխությունը.
`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	Բաժանման արդյունքները չպետք է վստահվիրա: Ավտոմական փորձությունն անհրաժեշտ է, որպեսզի խուսափենք երկրորդ թիվը բաժինել:Բաժանման արդյունքները չպետք է վստահվիրա: Ավտոմական փորձությունն անհրաժեշտ է, որպեսզի խուսափենք երկրորդ թիվը բաժինել:

Մեկը վերադարձնում է մի մանրամաս {"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 Կարելի է ասել միայն ունկնդիրը ։