Sākotnēji

API dokumentācija

Sarakstu, ziņojumu un peļņu, tieši no jūsu lietojumprogrammas.

GET

Sāciet ar vienu pieprasījumu

13 · API KomandasREST + handler_api.phpJSON / plain text · Bearer

Ievadiet API atslēgu jūsu dashboard, saņemjiet numuru un pārbaudiet ziņojumus ik pēc 20 sekundēm. maksājums tiek kreditēts, kad SMS ar kodu nonāk; atkārtoti lasot to neietekmē jūsu līdzsvaru.

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

saderības API bāzes URLhttps://smscash.org/stubs/handler_api.php

Pakalpojums ir dzīvstālruņa numuri , SMS Ieguvumi ir pieejami. atcelšanas ir pieejamas USDT uz TRC20Maksājumi ietver starp 1 un 45 Dienas ir.

Ātrā sākuma · 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}'

Alternatīva saderīga saskarnes adrese: /handler_api.php. pastāvošās REST integrācijas turpina strādāt.

REST API

Pieprasījumu veidotājs

cURL · Go · JS · Python

pieprasījumsPakalpojums APIValsts APIOperators operatorProgrammatūras īpašnieks kods refIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

Automātiska izvēle: visvairāk kodu pēdējā stundā, pēc tam 24 stundās. Nav numuru: nākamais operators.

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 Atslēga

Atslēga netiek saglabāta. Šī pārbaude nepiešķir numurus.

Atlikušo jaunās integrācijas

Pakalpojumi un valstis

Izvēlieties pakalpojumu un valsti. maksājumi SMS atkarībā no valsts.

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)

Iegūt skaitli

REST

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

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

Automātiska izvēle: visvairāk kodu pēdējā stundā, pēc tam 24 stundās. Nav numuru: nākamais operators.

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

Šis skaitlis ir derīgs 20 Minūti ir. SMS Katrs pārbaudīts 20 Jūs varat atcelt to uzreiz.

Pārbaudīt vairākus numurus

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

Atlikums · Aizturēts

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 — Pieejams; held_balance — Aizturēts. USD · 8

Var izņemt tikai līdzekļus, kuru aizturēšanas termiņš ir beidzies.

Gatavi klienti

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 · saderības API bāzes URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · saderības API bāzes URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Lietotāja personīgā API atslēga.

Izvēlieties pakalpojumu un valsti. maksājumi SMS atkarībā no valsts.

Kodeja	Apraksts
`getNumber / getNumberV2`	Iegūt skaitli
`getStatus / getStatusV2`	Iegūstiet jaunāko kodu
`setStatus / finishActivation / cancelActivation`	Sēdes vadības
`getPrices / getNumbersStatus`	Pārbaudi pieejamību
`getRewards (SMScash)`	SMS balva
`getServicesList / getServices`	Pakalpojumi
`getCountries / getOperators`	Pakalpojumi un valstis
`getActiveActivations`	sesijas
`getBalance`	Lietotāja atlikums
`getHoldBalance (SMScash)`	Aizturēts

cost = 0 USD · activationCost = 0 USD
reward — SMS balva

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'

atbildes

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

Šis skaitlis ir derīgs 20 Minūti ir. SMS Katrs pārbaudīts 20 Jūs varat atcelt to uzreiz.

Autentizācija un atgriešanās

REST: Header Authorization: Bearer YOUR_API_KEY. Kompatīvais saskarne: Parametri api_key un actionIzmantojiet HTTPS

Lai pārvaldītu API atslēgas, ievadiet savu kontu.

∞pieprasījumi / minūtē pēc konta

∞Vienlaicīgas sesijas

API pieprasījuma frekvence un tālruņa numura skaits ir neierobežots. nav ikdienas vai stundu kvotas.

Šis skaitlis ir derīgs 20 Minūti ir. SMS Katrs pārbaudīts 20 Jūs varat atcelt to uzreiz.

Pārējais ir unikāls Idempotency-Key ir nepieciešama numura piešķiršanai, atkārtota piešķiršana, atgriešanās un maksājumu pieprasījumi. tas ir opcionāls, bet ieteicams handler_api.php. atkārtoti izmantot atslēgu, kad atgriežas tīkla pieprasījums; izmantot jaunu atslēgu jaunai darbībai.

API atslēga

Jūs varat ierobežot atslēgu uz konkrētām pakalpojumiem, valstīm un pakalpojumu sniedzējiem. tukši saraksti ļauj visas pieejamās iespējas.

JSON

{
  "label": "Mūsu programmatūra",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} mainīt nosaukumu un politiku pilnībā. noslēpums tiek parādīts tikai tad, kad tas ir radīts.

10% kopumā. 5% + 5% ar programmatūras kodu.

Ja izdodat numuru, lūdzu, sniegt ref programmatūras īpašnieks. pieprasījumu apstiprina izpildītāja atslēga. koda ir sadaļā "Referrals" un GET /api/v1/referrals → software_ref.

pieprasījums	uzaicinājums	Programmatūra
Bez ref	10%	—
Ar ref	5%	5%
Ar ref, bez referera	—	5%

Platformas maksā bonusu, nesamazinot darba ņēmēja peļņu. programmatūras īpašnieks un referents var būt tāda pati persona. darba ņēmējs nevar izmantot savu kodu.

Nosacījumi ir fiksēti, kad tiek izveidota sesija; lasot SMS un atgriešanās tos nemainās. Pārsūtīt ref atkal par jaunu atkārtošanās sesiju. Tarifa aprēķinā lietotājam atalgojums USD 0.003 dod USD 0.00015 katrs programmatūras īpašniekam un referentam. Kopējais bonuss ir USD 0.00030.

API Komandas

11 XVBC stila metodes plus jūsu SMScash līdzsvars.

GETgetNumberIegūt skaitli

Sēdi veido un rezervē darba ņēmējam pieejamo numuru. atalgojuma likme un atsauces saņēmēji tiek fiksēti piešķīruma; atalgojums tiek kreditēts, kad ierodas SMS ar kodu.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`service`*	string	Pieejami pakalpojumu kodi. atbilde ir ierobežota ar API atslēgas apgabalu.
`country`*	integer	Iegūstiet ID no getCountries.
`operator`	string	Iegūstiet ID no operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	Sēdija ilgst 20 minūtes.Pārstāt 20 vai izslēdziet šo parametru.
`with_operator`	integer	1 pievieno atbildei operatora ID; 0 vai izlaists parametrs atgriež trīs daļas.
`ref`	string	Programmatūras īpašnieka publiskais kods: 5% Viņam un 5% Viņa aicināja – bez ref - 10% Uz uzaicinātāju.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getNumber.

Piemērs pieprasījums

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)

atbildes

Izdotais numurs

ACCESS_NUMBER:42:380670000000:1

Nav pieejamu numuru

EMPTY_POOL

Automātiska izvēle: visvairāk kodu pēdējā stundā, pēc tam 24 stundās. Nav numuru: nākamais operators.
Pas Idempotency-Key: tajā pašā pieprasījums ar to pašu atgriežas iepriekšējā sesija. Izmaiņas parametrus aicinājumus IDEMPOTENCY_CONFLICT.
Numeriskā valsts bez baseina dod EMPTY_POOL; nepareiza valsts formāta ir BAD_COUNTRY.
Izdzēstās sesijas atslēga joprojām tiek izmantots: atkārtoti atskaņošanas atskaņošana ar šo atslēgu atgriežas SESSION_CLOSED un neizdod citu numuru.
Atdalīšanas rezultāts nav apstiprināts. automātiskā atbrīvojuma funkcija ir neieslēgta, lai izvairītos no otrā numura atdalīšanas.

GETgetNumbersStatusPārbaudi pieejamību

Tālruņa numuri pieejami pēc pakalpojuma un valsts.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`country`*	integer	Iegūstiet ID no getCountries.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getNumbersStatus.

Piemērs pieprasījums

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())

atbildes

pieejamie skaitļi

{
  "go_0": 0
}

_0 suffix nozīmē izvēli bez konkrēta operatora.
Pieejamība attiecas uz piegādātāja kopējo baseinu. izvēlētā kanāla tiek pārbaudīta, kad tiek piešķirta numurs.

GETgetStatusIegūstiet jaunāko kodu

Vienkārša pieprasījums sesijas statusa un pēdējā SMS koda.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`id`*	integer	Jūsu sesijas ID, kas saņemts, kad tika izsniegts numurs.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getStatus.

Piemērs pieprasījums

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)

atbildes

Gaidām

STATUS_WAIT_CODE

Iegūtā koda

STATUS_OK:001234

Atcelšana vai izbeigšana

STATUS_CANCEL

Nav atrasts

NO_ACTIVATION

Poll ik pēc 20 sekundēm. atkārtoti lasīt ziņojumu nerada citu maksājumu.
Pēc retry vecā kods nav atgriezts: getStatus gaida nākamajam SMS.
Pēc dažiem bez SMS ir izdzēsts, getStatus un getSms Atgriešanās STATUS_CANCEL; getSmsFull atgriežas slēgta stāvokļa, tukšs tālrunis un tukšs sms saraksts → REST /activations/{id} un /sms Atgriešanās 404 NO_ACTIVATION.

GETsetStatusSēdes vadības

Pabeidzas, atceļ vai atkārtoti gaida SMS. sesijas beigas paliek tādas pašas.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`id`*	integer	Jūsu sesijas ID, kas saņemts, kad tika izsniegts numurs.
`status`*	integer	3 — gaida nākamo kodu, nepārtraucot sesiju; 6 — beidzas pēc SMS; 8 — nekavējoties atcelt.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =setStatus.

Piemērs pieprasījums

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)

atbildes

Gaidām SMS

ACCESS_RETRY_GET

Pabeigta

ACCESS_ACTIVATION

Atcelt

ACCESS_CANCEL

Atgriešanās gaida nākamo kodu 20 minūšu laikā no sākotnējās. izdošanas un izbeigšanas laiks nemainās.
Par statusu =3 Izmantojiet Idempotency-Key: atkārtoti pieprasījums neatgriezīs jaunu kodu, kas jau ir saņemts. SMS Tas paliek pieejams.
Atcelšana neatņem jau nopelnītos balvas.
Vēsturei tiek saglabāti tikai numuri ar SMS kodu. atcelti un beidzies numuri bez koda tiek dzēsti.

GETgetRepeatNumberAtkārtoti izrakstīt to pašu numuru

Atver jaunu sesiju ar konkrētu numuru no jūsu vēstures. Jūs varat izvēlēties citu pieejamo pakalpojumu tajā pašā valstī.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`number`*	string	Jūsu vecais numurs. atļauti tikai numuri un opcionāls vadošais +.
`service`*	string	Pieejami pakalpojumu kodi. atbilde ir ierobežota ar API atslēgas apgabalu.
`session_duration`	integer	Sēdija ilgst 20 minūtes.Pārstāt 20 vai izslēdziet šo parametru.
`with_operator`	integer	1 pievieno atbildei operatora ID; 0 vai izlaists parametrs atgriež trīs daļas.
`ref`	string	Programmatūras īpašnieka publiskais kods: 5% Viņam un 5% Viņa aicināja – bez ref - 10% Uz uzaicinātāju.
`operator`	string	Iegūstiet ID no operators/getOperators (API). `operator=1 · any/0`

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getRepeatNumber.

Piemērs pieprasījums

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)

atbildes

Jaunā sesija

ACCESS_NUMBER:43:380670000000

Numurs joprojām ir aizņemts

NUMBER_IN_USE

Pirmkārt, beidziet vai atcerieties savu pašreizējo sesiju. ja numurs ir aizņemts, atkārtoti izņemšana netiek veikta.
Jaunais sesijas saņem jaunu ID un pašreizējo tarifu. veco SMS nav kopēts tajā. ref tiek iestatīts atkal.
SMScash ļauj atkārtot tikai skaitļus no šīs konta vēstures.
Izdzēstās sesijas atslēga joprojām tiek izmantots: atkārtoti atskaņošanas atskaņošana ar šo atslēgu atgriežas SESSION_CLOSED un neizdod citu numuru.

GETgetSmsFullSMS kā JSON

Strukturēta vēsture visiem ziņojumiem ar ID, sūtītāja, koda, teksta un valsts, pakalpojumu un piegādātāja datiem.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`id`*	integer	Jūsu sesijas ID, kas saņemts, kad tika izsniegts numurs.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getSmsFull.

Piemērs pieprasījums

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())

atbildes

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

Atcerieties sms[].id, lai apstrādātu tikai jaunas ziņas.
Numeriskā statusa SMScash: 1 - aktīvs, 6 - pabeigts, 8 - atcelts vai izbeigts. status_name atšķiras gaidīšanas, saņemšanas, pabeigšanas, atcelšanas, izbeigšanas.
Saņemtie kodi joprojām ir pieejami pēc sesijas slēgšanas. Lielo apjomu lietošana REST /activations/{id}/sms ar after_id.
Pēc dažiem bez SMS ir izdzēsts, getStatus un getSms Atgriešanās STATUS_CANCEL; getSmsFull atgriežas slēgta stāvokļa, tukšs tālrunis un tukšs sms saraksts → REST /activations/{id} un /sms Atgriešanās 404 NO_ACTIVATION.

GETgetSmsSMS kā teksta riteņa

Atgriež visu SMS vēsturi sīkrīku formātā esošajiem klientiem.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`id`*	integer	Jūsu sesijas ID, kas saņemts, kad tika izsniegts numurs.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getSms.

Piemērs pieprasījums

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)

atbildes

vēstījums

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

Gaidām

STATUS_WAIT_CODE

Atcelšana vai izbeigšana

STATUS_CANCEL

Saziņas formāts: laika koda koda tekst. Daudzas ziņas ir atdalītas ar kolonnu.
SMS pats var saturēt kolonnas un vertikālas raksti.Tikumīgas parsēšanas nolūkos izmantojiet getSmsFull.

GETgetServicesPakalpojumi

Pieejami pakalpojumu kodi. atbilde ir ierobežota ar API atslēgas apgabalu.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`country`	integer	Iegūstiet ID no getCountries.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getServices.

Piemērs pieprasījums

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())

atbildes

Pakalpojumi

{
  "go": {
    "name": "Google",
    "code": "go"
  }
}

Pakalpojumu katalogs tiek koplietots starp piegādātājiem. numura pieejamība tiek pārbaudīta atsevišķi.

GETgetCountriesValstis

ID, vārdi un zvanu kodi valstu izvēlētajā kanālā.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getCountries.

Piemērs pieprasījums

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())

atbildes

Valstis

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

GETgetOperatorsOperatori

Pieejamie operatori: API ID, nosaukums un atlīdzības aizturēšanas periods.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`country`	integer	Iegūstiet ID no getCountries.
`operator`	string	Iegūstiet ID no operators/getOperators (API). `operator=1 · any/0`

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getOperators.

Piemērs pieprasījums

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())

atbildes

Operatori

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

Iegūstiet ID no operators/getOperators (API).

GETgetRewardsSMS balva

Ieguldījumi ir atkarīgi no valsts. visas tabulas summas ir par samaksātu SMS.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.
`country`	integer	Iegūstiet ID no getCountries.
`service`	string	Pieejami pakalpojumu kodi. atbilde ir ierobežota ar API atslēgas apgabalu.
`operator`	string	Iegūstiet ID no operators/getOperators (API). `operator=1 · any/0`

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getRewards.

Piemērs pieprasījums

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())

atbildes

JSON

{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}

{}

{}

USD tarifa summas tiek atgrieztas precīzi desmitdaļās ar 8 desmitdaļām:
Iegūtā piegādātāja pieejama jūsu atslēgvārdu.
country ID → service code → operator ID → reward (USD)

GETgetBalanceLietotāja atlikums

Papildu SMScash: pieejamais bilances, ņemot vērā akrūzes, atsauces bonusu un maksājumu pieprasījumu.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getBalance.

Piemērs pieprasījums

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)

atbildes

Atlikums

ACCESS_BALANCE:0.00

getBalance atgrieža pieejamo USD līdzsvars ar līdzekļu 8 decimālas vietas.
Var izņemt tikai līdzekļus, kuru aizturēšanas termiņš ir beidzies.

GETgetHoldBalanceAizturēts

Pēc SMS saņemšanas ienākumi tiek aizturēti uz piegādātāja noteikto laiku. Norādītajā datumā summa automātiski kļūst pieejama izņemšanai.

Parametri

Parametri	Tipi	Apraksts
`api_key`*	string	Lietotāja personīgā API atslēga.

* Pieprasīts parametrs. visās pieprasījumās arī iet darbība =getHoldBalance.

Piemērs pieprasījums

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)

atbildes

Aizturēts

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Var izņemt tikai līdzekļus, kuru aizturēšanas termiņš ir beidzies.

Atbildes kodi un atkārtotas pieprasījumus

Ievadīšana handler_api.php uzņēmējdarbības rezultāti parasti ir ar HTTP 200. Pārbaudiet ķermeņa tekstu. katalogu un getSmsFull atgriešanās JSON ja ir veiksmīga; kļūdas vienmēr ir teksts.

Kodeja	HTTP	Iemesls un nākamais solis
`TARIFF_NOT_CONFIGURED`	200	Rēķini vēl nav nostiprinātiNumura piešķiršana sākas, kad tiek konfigurētas SMS balvas.
`COUNTRY_BLOCKED`	200	Šīs valsts numura piešķiršana ir bloķēta.Izvēlieties citu valsti.
`BAD_SERVICE`	200	Šīs pakalpojuma numura piešķiršana ir bloķēta.Izvēlieties citu pakalpojumu.
`PROVIDER_NOT_READY`	200	Ieguldījums ir pagaidu nepieejamsAtjauniniet API katalogus.
`BAD_KEY`	400	Nē api_key vai nepareizi formāti.Pārbaudiet atslēgu pieprasījumā.
`INVALID_API_KEY`	401	Atslēga nav zināma, atcelta vai konta ir neaktivizēta.Izveidojiet spēkā esošo API atslēgu.
`BAD_COUNTRY`	400	Tātad, valsts ir vai nav pozitīva skaitļa.Iegūstiet ID no getCountries.
`BAD_SESSION_DURATION`	400	Tālruņa numuri tiek izsniegti tieši 20 minūtes.Korekcija session_duration.
`BAD_REQUEST`	400	Nepareizi parametri vai Idempotency-Key.Lūdzu, pareizi izlabojiet savu pieprasījumu.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Nezināma vai traucēta adreses priekšmets.Atjauniniet API katalogus.
`BAD_NUMBER`	200	Nepareiza numura formāta.Ievadiet numuru skaitļos.
`BAD_ACTION / BAD_STATUS`	200	Nezināma komanda, ID vai operācija.Pārbaudiet iestatījumus.
`EMPTY_POOL`	200	Pašlaik nav pieejami neviena atbilstīga telefona numuri.Atkārtojiet pēc 10-30 sekunžu vai mainīt filtru.
`NUMBER_IN_USE`	200	Īpašs skaitlis ir aizņemts ar aktīvu sesiju.Pabeigt sesiju vai izvēlēties citu numuru.
`NO_ACTIVATION`	200	Sēdes vai iepriekšējais numurs nav jūsu kontā.Pārbaudiet ID un atslēgu.
`SESSION_CLOSED / SMS_REQUIRED`	200	Pašreizējā valsts pāreja nav pieejama.Pārbaudiet SMS nosacījumu un pieejamību.
`SCOPE_BLOCKED`	200	Pakalpojums, valsts vai piegādātājs nav atļauts par atslēgu.Atjaunināt API atslēgas apjomu.
`IDEMPOTENCY_CONFLICT`	200	Šis meklēšanas atslēga jau ir saistīta ar citiem parametriem.Jauna operācija, izveidojiet citu Idempotency-Key.
`BAD_REF / SELF_REF`	400	Programmatūras kods ir nezināms, neuzstādīts vai pieder pašiem darba ņēmējiem.Ievērojiet programmatūras īpašnieka kodu.
`INTERNAL_ERROR`	500	Pagaidu servera vai piegādātāja kļūda.Atkārtoti ar kavēšanu un tādu pašu Idempotency-Key.
`ALLOCATION_PENDING`	200	Numurs sadalījums jau ir turpmāk. Atkārtotiet ar tādu pašu Idempotency-Key.Numurs sadalījums jau ir turpmāk. Atkārtotiet ar tādu pašu Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	Atdalīšanas rezultāts nav apstiprināts. automātiskā atbrīvojuma funkcija ir neieslēgta, lai izvairītos no otrā numura atdalīšanas.Atdalīšanas rezultāts nav apstiprināts. automātiskā atbrīvojuma funkcija ir neieslēgta, lai izvairītos no otrā numura atdalīšanas.

Pārējais atgriežas objektu {"error":{"code":"…","message":"…"}} un regulāri HTTP statusi 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Pārbaudiet pieprasījumu laukumus.",
    "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.

Atlikušo jaunās integrācijas

USD tarifa summas tiek atgrieztas precīzi desmitdaļās ar 8 desmitdaļām: 0.00300000 USD.

Balansu valūta ir USD. pieprasījumu un atbildes shēmas ir pieejamas OpenAPI.

Izņemšana USDT · TRC20Izmaksas aizņem no 1 līdz 45 dienām. Izņemšanas komisija ir 4 $. To ietur no pieprasītās summas. Pēc SMS saņemšanas ienākumi tiek aizturēti uz piegādātāja noteikto laiku. Norādītajā datumā summa automātiski kļūst pieejama izņemšanai. Var izņemt tikai līdzekļus, kuru aizturēšanas termiņš ir beidzies.

GET/api/v1/catalogPakalpojumi un valstis

GET/api/v1/tariffsSMS balvas tarifi pēc valsts

GET/api/v1/offersIeguldījumi un balvas

GET/api/v1/servicesdirektors

GET/api/v1/countriesdirektors

GET/api/v1/operatorsdirektors

GET/api/v1/availability?country=1pieejamības numurs

POST/api/v1/activationsJaunā sesija

GET/api/v1/activations/batch?ids=42,43Pārbaudīt vairākus numurus

GET/api/v1/activationsPēdējās 200 sesijas: apjoms = vēsture, gaidīšana vai viss

GET/api/v1/activations/{id}Sēdes un ziņojumi

GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS ar kuroru

POST/api/v1/activations/{id}/retryGaidām SMS

POST/api/v1/activations/{id}/finishPabeigšana

POST/api/v1/activations/{id}/cancelAtcelt

POST/api/v1/activations/repeatAtgriešanās numurs

GET/api/v1/keysAPI atslēgas

POST/api/v1/keysIzveidojiet atslēgu

PATCH/api/v1/keys/{id}Mainīt nosaukumu vai politiku

DELETE/api/v1/keys/{id}Atgrieziet atslēgu

GET/api/v1/referralsReferences kods un peļņa

GET/api/v1/summaryBalans un kopsavilkums

GET/api/v1/balanceAizturēts

GET/api/v1/ledgerIeguvumi Ledger

GET/api/v1/withdrawalsMaksājumu pieprasījumi

POST/api/v1/withdrawalsIzveidojiet pieprasījumu

GET/api/v1/statisticsVispārējā statistika

GET/api/v1/earnings/holdsIenākumu aizturēšana

Tikai jauni 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": "Koda numurs: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Saglabāt next_cursor un pārdod to, kā after_id. Ja has_more=true, nākamajā lapā var nekavējoties lasīt. ierobežojums: 1–200. Sesijas un SMS ir pieejami tikai īpašniekam.