စတင်နေသည်

API ဖိုင်တွဲ

စာမျက်နှာ ။

GET

တောင်းဆိုချက်တစ်ခုဖြင့်စတင်ပါ

13 · API အမိန့်ပေးချက်များREST + handler_api.phpJSON / plain text · Bearer

ဖန်တီးပါ API ဒေတာဘာဒမှာ ကီး အရေအတွက် ရယူပြီး စကားများကို စစ်ဆေးပါ 20 စက္ကန့်များ။ ဆုတောင်းချက်ကို အသုံးပြုရန် SMS ဥပမာ ၊

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

ဆက်သွယ်မှု API အခြေအနေ URLhttps://smscash.org/stubs/handler_api.php

အမှုသည် အသက်ရှင်နေပါသည်တောဖုန်နံပါတ်၊ SMS သို့သော် ငွေကြေး များ ကို သုံးသပ် ကြည့်ပါ ။ USDT အတည်ပြု TRC20. ငွေကြေးများကို ယူခဲ့သည် 1 နှင့် 45 ကာလ

အမြန်စတင်မှု · REST / cURL

curl -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  -d '{"service":"go","country":86}'

အခြေအနေတဲ့ အဆက်အသွယ် အလိပ်စာ: /handler_api.php. ရရှိထားသော REST အတွင်းတည်ဆောက်မှုကို ဆက်လုပ်နေသည်။

REST API

တောင်းဆိုချက် ဖန်တီးကိရိယာ

cURL · Go · JS · Python

တောင်းဆိုချက်အမှု APIနိုင်ငံ APIအပ္ပလီတာ operatorဆော့ဝဲနဲ့ အခြေအနေ ကုဒ် refIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

အလိုအလျောက်ရွေးချယ်မှု — ပြီးခဲ့သည့်တစ်နာရီ၊ ထို့နောက် ၂၄ နာရီအတွင်း ကုဒ်အများဆုံးရရှိသူ။ နံပါတ်မရှိလျှင် နောက်ဝန်ဆောင်မှုပေးသူ။

cURL

curl --max-time 15 --fail-with-body -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  --data '{"service":"go","country":86}'

package main

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

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

JavaScript

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

Python

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

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

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

API ကီး

ကီးကို မသိမ်းဆည်းပါ။ ဤစစ်ဆေးမှုသည် နံပါတ်များ မပေးပါ။

အဖွဲ့အစည်းအဝေးများအတွက်

ဝန်ဆောင်မှုများနှင့် နိုင်ငံများ

ဝေဒနာနှင့် နိုင်ငံကို ရွေးပါ။ SMS အတွက် ဆေးဝါးကပ်တိုင်ပြည်မှ အခြေအနေရှိသည်။

REST

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

JSON

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

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

စာမျက်နှာကို ရရှိပါ

REST

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

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

REST

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

အရေအတွက် အမှား 20 မိနစ် SMS စစ်ဆေးရန် 20 စက္ကန့်များ။ ချက်ချင်း ပယ်ဖျက်နိုင်သည်

နံပါတ်များစွာ စစ်ဆေးရန်

REST

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

JSON

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

REST

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

လက်ကျန်ငွေ · ဆိုင်းငံ့ထားသောငွေ

REST

GET /api/v1/balance
Authorization: Bearer YOUR_API_KEY

JSON

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

balance — ရရှိနိုင်သည်; held_balance — ဆိုင်းငံ့ထားသောငွေ. USD · 8

ဆိုင်းငံ့ကာလပြီးဆုံးသောငွေကိုသာ ထုတ်ယူနိုင်သည်။

အသင့်သုံး ကလိုင်းယင့်များ

JavaScript / Node.js ↓Python ↓

JavaScript · Node.js 18+

import {SmScash, SmScashError} from './smscash.mjs';
import {randomUUID} from 'node:crypto';

const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);

// Save this key before sending; keep it for retries of this operation.
const requestKey = randomUUID();
const session = await api.createNumber({service: 'go', country: 86}, requestKey);
// After 20 seconds:
const messages = await api.sms(session.id, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([session.id]);
const held = await api.holdBalance();
console.log(held); // Exact USD string

Python 3.9+

import os
import uuid
from smscash import SmScash, SmScashError

api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])

# Save this key before sending; keep it for retries of this operation.
request_key = str(uuid.uuid4())
session = api.create_number({'service': 'go', 'country': 86}, request_key)
# After 20 seconds:
messages = api.sms(session['id'], after_id=0)
print(messages['sms'])
statuses = api.batch([session['id']])
held = api.hold_balance()
print(held) # Exact USD string

SDK

me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
createNumber(parameters, requestKey) / create_number(parameters, request_key)
setStatus(id, "cancel") / set_status(id, "cancel")
setStatus(id, "retry", requestKey) / set_status(id, "retry", request_key)
Timeout: 15 s · no dependencies · no automatic retries
Error: code · status · hint · requestId/request_id · retryable
ALLOCATION_UNCERTAIN: contact support with request_id; never retry automatically.

SMS-Activate / HeroSMS

SMS-Activate · ဆက်သွယ်မှု API အခြေအနေ URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · ဆက်သွယ်မှု API အခြေအနေ URLhttps://smscash.org/hero-sms/stubs/handler_api.php

အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။

ကုဒ်	ဖော်ပြချက်
`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.

အသိအမှတ်ပြုလွှာ

REST: ခေါင်းစဉ် Authorization: Bearer YOUR_API_KEY. တူညီသော အ interface အခြေအနေများ api_key နှင့် action. HTTPS ကို သုံးပါ

API ကီးများကိုစီရင်ဖို့ အကောင့်ထည့်ပါ

∞အကောင့်တစ်ခု တောင်းဆိုချက်/မိနစ်

∞အချိန်ပြည့်ဆက်ရှင်များ

API အခွင့်အရေးအတွက် အလွန်အလွန်လျှော့ထားတဲ့ အခြေအနေများကို မလုံလောက်ဘူး။ နေ့ရက်နဲ့ နာရီရောဂါများမရှိပါ။

မြေကြီး ပေါ် တွင် အခြေအနေ တစ် ခု Idempotency-Key နံပါတ်ခွဲခြားရာအတွက် လိုအပ်တဲ့ retry သို့မဟုတ် အခွင့်အရေး မေးခွန်းများ handler_api.php. ကွန်ယက် တောင်းဆိုချက်ကို ပြန်ကြိုးစားချိန်တွင် ကီးကို ပြန်သုံးပါ။ ကီး အသစ်ကို လုပ်ဆောင်မှုအသစ်အတွက် သုံးပါ

API ကီး စီးပွားရေး

ရွေးချယ် ထား သည့် ရွေးနုတ် ဖိုး အားလုံး ကို ခွင့်ပြု နိုင်သည် ။

JSON

{
  "label": "အကျွန်ုပ်ဆော့ဝဲ",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} နာမည်နှင့် ပညာရှင်များကို အပြည့်အစုံပြောင်းပါ။ ဖန်တီးသောအခါသာ ဖော်ပြသည်။

10% ဥပမာ ၊ 5% + 5% ဆော့ဝဲ ကုဒ်နှင့်

နံပါတ်များကို ထုတ်ယူစဉ်ပေးပါ ref ဆော့ဝဲ၏ ဝိညာဉ်ပုရောဂျက်။ တောင်းဆိုချက်ကို တည်ဆောက်ခဲ့တယ်။ အက္ခရာက "အရည်အသွေး" အခန်းထဲမှာ ရှိပါသည်။ GET /api/v1/referrals → software_ref.

တောင်းဆိုချက်	ဖိတ်ခေါ်သူ	ဆော့ဝဲ
မျက်နှာဖုံး	10%	—
Ref နှင့်	5%	5%
နီ ဖ် နှင့် အတူ ၊	—	5%

အသုံးပြုသူ၏ အရည်အသွေးများကို ငြင်းပယ်ခြင်းမရှိဘူး။ ဆော့ဝဲ အခြေအနေ နှင့် ရည်ရွယ်သူသည် တစ်ယောက်တည်း ဖြစ်နိုင်သည်။ လုပ်ဆောင်သူသည် မိမိ၏ ကုဒ်ကို သုံးလို့မလား။

ဆက်ရှင်တစ်ခုဖန်တီးသည့်အခါ အခြေအနေများကို တည်ဆောက်ထားသည်။ ဖတ်ရန် SMS နှင့် retry သို့မဟုတ် မပြောင်းပါ ref ဒုတိယ ဆက်သွယ်ချက် အသစ် အတွက် ပြန်လာပါတယ်။ တာဝန်အရေတွက်တွင် အလုပ်အသုံးပြုသူရလွှတ်တယ် USD 0.003 ပေးသည် USD 0.00015 ဆော့ဝဲနဲ့ အခြေအနေအတွက် အသုံးပြုတယ်။ ထူးခြားသော ဂုဏ်သတ္တိ USD 0.00030.

API အမိန့်ပေးချက်များ

11 XVBC- အမျိုးအစားများနှင့် SMScash ဥပမာ ၊

GETgetNumberစာမျက်နှာကို ရရှိပါ

ဆက်ရှင်တစ်ခုကို ဖန်တီးပြီး အလုပ်ရှင်အတွက် ရရှိနိုင်သော အရေအတွင်းကို စည်းဝေးထားပါတယ်။ ရွေးချယ်ချက်များနှင့် ရည်ညွှန်းခြင်းများကို အခြေအနေတွင် တည်ဆောက်ထားသည်။ အက္ခရာအတိုင်း SMS ရောက်လာတဲ့ အရည်အသွေးကို မှတ်တမ်းထားပါသည်။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`service`*	string	ရရှိနိုင်သော service အက္ခရာများ။ ဖြောင့်မတ်သည် API ကီး၏ အရပ်ကွက်တွင်သာပါသည်။
`country`*	integer	getCountries မှ အမည် ယူပါ
`operator`	string	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

အလိုအလျောက်ရွေးချယ်မှု — ပြီးခဲ့သည့်တစ်နာရီ၊ ထို့နောက် ၂၄ နာရီအတွင်း ကုဒ်အများဆုံးရရှိသူ။ နံပါတ်မရှိလျှင် နောက်ဝန်ဆောင်မှုပေးသူ။
ပြောင်းလဲ Idempotency-Key: မျက်နှာခေါ်တဲ့ ဆက်သွယ်ချက်ကို တည်းဖြတ်ပါ။ အခြေအနေ ခေါင်းစဉ်ကို ပြောင်းပါ IDEMPOTENCY_CONFLICT.
Pool မရှိသော နိုင်ငံ အရေအတွက် EMPTY_POOL ပေးသည်။ မမှန်ဘူးပြည် အမျိုးအစား BAD_COUNTRY ဖြစ်သည်။
ပယ်ဖျက်ထားသော ဆက်ရှင်၏ ကီး ကီး သည် သုံးသပ်နေသည်။ ထိုကီးနှင့် တည်ဆောက်မှုကို ပြန်ဖွင့်ရန် SESSION_CLOSED ကို ပြန်ရန် အခြားနံပါတ်ကို ဖွင့်မထားပါ။
ဒုတိယ အရည်အသွေးကို မတည်ဆောက်ပါဘူး။ အလိုအလျောက်ကြားကြိုးစားခြင်းကို ခွဲခြားစေခြင်းငှါ ခွင့်ပြုခြင်းကို မပြုလုပ်နိုင်ပါ။

GETgetNumbersStatusအသုံးပြုမှုကို စစ်ဆေးပါ

ဥပမာ ၊

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`country`*	integer	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 အပိုဒ်ကိရိယာကို အသိအမှတ်ပြုသူမရှိသော ရွေးချယ်မှုဟူမူကား
ရွေးချယ် ခံ ရ သော အခြေအနေ တစ် ခု ကို သုံးသပ် ကြည့်ပါ ။

GETgetStatusနောက်ဆုံး အက္ခရာကို ရရှိပါ

ဆက်ရှင် အခြေအနေ နှင့် နောက်ဆုံး SMS ကုဒ်အတွက် လျစ်လျူရှုပါ။ အက္ခရာတွင် သိမ်းဆည်းနေသည်။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`id`*	integer	သင်၏ဆက်ရှင်၏ အမည်၊ အရေအတွက် ထုတ်ပြီးမှ လက်ခံရသည်။

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=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	သင်၏ဆက်ရှင်၏ အမည်၊ အရေအတွက် ထုတ်ပြီးမှ လက်ခံရသည်။
`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 ဥပမာ ၊
အခြေအနေအတွက်=3 အသုံးပြု Idempotency-Key: တောင်းဆိုချက်ကို ပြန်ပြန်ပေးရန် ကုဒ်အသစ်ကို ပြန်လည် မပြုလုပ်နိုင်ပါ။ SMS ဥပမာ ၊
ငြိမ် သက် ခြင်း သည် အလွန် ခံစား ရ သော အကျိုးကျေးဇူး များ ကို မ ဖယ်ရှားပါ။
SMS ကုဒ်နဲ့နံပါတ်တစ်ခုသာ သမ္မာကျမ်း စာတည်နေသည်။ အက္ခရာမရှိနိုင်သောနံနံရံများကို ပယ်ဖျက်ရန်

GETgetRepeatNumberနံပါတ်တစ်ခုကို ပြန်ကြည့်ပါ

သမ္မာကျမ်း စာမှ အသိအမှတ်ပြုလွှာ အသစ်ကို ဖွင့်ပါ။ နိုင်ငံတစ်ခုတည်း ရှိနိုင်သော အမှုကို ရွေးနုတ်နိုင်ပါသည်။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`number`*	string	နံပါတ်အရှေ့တစ်ခု။ ရွေးချယ်ထားတဲ့ အရေအတွက် + သာက ခွင့်ပြုရန်။
`service`*	string	ရရှိနိုင်သော service အက္ခရာများ။ ဖြောင့်မတ်သည် API ကီး၏ အရပ်ကွက်တွင်သာပါသည်။
`session_duration`	integer	ဆက်ရှင်က နေထိုင်သည် 20 မိနစ် 20 သို့မဟုတ် ပရိုဂရမ်ကို ပယ်ဖျက်ပါ
`with_operator`	integer	1 သည် တုံ့ပြန်ချက်တွင် အော်ပရေတာ ID ကို ထည့်သည်။ 0 သို့မဟုတ် ပါရာမီတာမပေးပါက အပိုင်းသုံးပိုင်း ပြန်ပေးသည်။
`ref`	string	ဆော့ဝဲ အဝတ်အစည်းအဝေး၏ လွှမ်းမိုး အက္ခရာ ကုဒ် - 5% သူ့အတွက်၊ 5% ဖိတ် ခေါ် ရာတွင် ref - 10% ဥပမာ ၊
`operator`	string	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

ရှေ့ဆုံး၊ လက်ရှိဆက်ရှင်ကို အဆုံးသတ်ပါ သို့မဟုတ် ရပ်တန့်ပါ။ အရေအတွက် အလုပ်ရှိလျှင် ပြန်လည်မလုပ်နိုင်ဘူး။
ဆက်ရှင်အသစ် က အမည် အသစ် နဲ့ လက်ရှိ တာရီတစ်ခုကို လက်ခံနေသည်။ SMS အရှေ့တွင် ကူးယူခြင်းမရှိပါ။ ref ပြန်သတ်မှတ်ထားသည်။
SMScash ဤအချက်အလက်အသစ်မှ အရေအတွက်များကိုသာ ပြန်ပြောဆိုခွင့်ပြုသည်။ နိုင်ငံသည် နံပါတ်အားဖြင့် သတ်မှတ်ထားသည်။
ပယ်ဖျက်ထားသော ဆက်ရှင်၏ ကီး ကီး သည် သုံးသပ်နေသည်။ ထိုကီးနှင့် တည်ဆောက်မှုကို ပြန်ဖွင့်ရန် SESSION_CLOSED ကို ပြန်ရန် အခြားနံပါတ်ကို ဖွင့်မထားပါ။

GETgetSmsFullJSON အဖြစ် SMS ရယူပါ

အမည်၊ ပေးပို့ရာ၊ ကုဒ်, စာသား၊ နိုင်ငံ၊ ဝေဒနာနှင့် စာရင်း ဒေတာ အားလုံး အတွက် တည်ဆောက်ထားတဲ့ သမ္မာကျမ်း စာ

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`id`*	integer	သင်၏ဆက်ရှင်၏ အမည်၊ အရေအတွက် ထုတ်ပြီးမှ လက်ခံရသည်။

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=getSmsFull ကိုပို့ရန်

ဥပမာ တောင်းဆိုချက်

curl

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

package main

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

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

javascript

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

python

import requests

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

ဖြေကြား

JSON

{
  "success": true,
  "session_id": 42,
  "phone": "380670000000",
  "status": 1,
  "status_name": "received",
  "sms_count": 1,
  "sms": [
    {
      "id": 101,
      "external_id": "message-101",
      "sender": "Service",
      "code": "001234",
      "text": "Код подтверждения: 001234",
      "received_at": "2026-10-09T12:00:00Z",
      "country": {
        "id": 86,
        "name": "Italy"
      },
      "service": {
        "code": "go",
        "name": "Google"
      },
      "provider": {
        "id": 1,
        "name": "Оператор 1"
      }
    }
  ],
  "expires_at": "2026-10-09T12:20:00Z"
}

ဖွဲ့စည်းမှုအတွက် အလိုအလျောက်အပ်ထားတဲ့ ပုံစံကို သိမ်းပါ။ sms[].id စကားအသစ်ကိုသာ လုပ်ဆောင်ရန်
အခြေအနေ SMScash: 1 - အတည်ပြု 6 - ပြီးပြီ 8 - ပယ်ဖျက် သို့မဟုတ် အဆုံးသတ်ပါ status_name မျှော်လင့်ခြင်း၊ လက်ခံခြင်း၊ ပြီးဆုံးခြင်း၊ ပယ်ဖျက်ခြင်း၊ ဆုံးရှုံးခြင်း
ဆက်သွယ်ချက် ပိတ်ပြီး လက်ခံရသော အက္ခရာများကို ရရှိနိုင်သည်။ အရွယ်အစားများအတွက် REST /activations/{id}/sms ကို after_id သုံးပါ။
အန္တရာယ်တစ်ခုနောက် SMS ပယ်ဖျက်ရန် getStatus နှင့် getSms ပြန်ရန် STATUS_CANCEL; getSmsFull ပိတ်ခဲ့သော အခြေအနေကို၊ အလွတ်ဖြတ်ပြီး လျှော့ပေးပါ sms စာရင်း REST /activations/{id} နှင့် /sms ပြန်ရန် 404 NO_ACTIVATION.

GETgetSmsSMS ကို စာသား စာလုံးပေါင်းအဖြစ် ရယူပါ

SMS သမ္မာကျမ်း စာတမ်း အတွက်ရှိသော ကလိုင်းယင့်များအတွက် စာလုံးပေါင်း အမျိုးအစားတွင် ပြန်လာသည်

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`id`*	integer	သင်၏ဆက်ရှင်၏ အမည်၊ အရေအတွက် ထုတ်ပြီးမှ လက်ခံရသည်။

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=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ဝန်ဆောင်မှုများ

ရရှိနိုင်သော service အက္ခရာများ။ ဖြောင့်မတ်သည် API ကီး၏ အရပ်ကွက်တွင်သာပါသည်။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`country`	integer	getCountries မှ အမည် ယူပါ

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=getServices ကိုပို့ရန်

ဥပမာ တောင်းဆိုချက်

curl

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

package main

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

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

javascript

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

python

import requests

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

ဖြေကြား

ဝန်ဆောင်မှုများ

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

ဆက်သွယ်သူဖိုင်လမ်းညွှန်ကို လက်ခံတဲ့ အတွင်း တည်ဆောက်ထားပါတယ်။ အရေအတွက် လက်မခံနိုင်ဘူးတယ်စစ်ဆေးရန်

GETgetCountriesနိုင်ငံများ

ရွေးချယ်ထားသော ချာနယ်တွင် နိုင်ငံများအတွက် အမည်၊ အမည်များ နှင့် ခေါ်ဆိုမှုများ

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=getCountries ကိုပို့ရန်

ဥပမာ တောင်းဆိုချက်

curl

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

package main

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

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

javascript

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

python

import requests

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

ဖြေကြား

နိုင်ငံများ

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

GETgetOperatorsအသုံးပြုသူများ

ရရှိနိုင်သော အော်ပရေတာများ: API ID၊ အမည်နှင့် ဆုကြေးထိန်းသိမ်းထားသည့်ကာလ။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`country`	integer	getCountries မှ အမည် ယူပါ
`operator`	string	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
  }
}

operators/getOperators (API) မှ အမည် ယူပါ

GETgetRewardsSMS အတွက် အကျိုးကျေးဇူး

အရောင်များသည် နိုင်ငံမှ အခြေအနေရှိပါသည်။ ဇယားကွက်အရေအတွက် အားလုံး သည် စာမျက်နှာ SMS တစ်ခုခု ဖြစ်သည်။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။
`country`	integer	getCountries မှ အမည် ယူပါ
`service`	string	ရရှိနိုင်သော service အက္ခရာများ။ ဖြောင့်မတ်သည် API ကီး၏ အရပ်ကွက်တွင်သာပါသည်။
`operator`	string	operators/getOperators (API) မှ အမည် ယူပါ `operator=1 · any/0`

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=getRewards ကိုပို့ရန်

ဥပမာ တောင်းဆိုချက်

curl

curl 'https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi'

package main

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

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

javascript

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

python

import requests

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

ဖြေကြား

JSON

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

{}

{}

USD ဒေါသတည်းဟူသော အရည်အသွေးများကို တည်ဆောက်ထားသည် 8 ဆယ်ဆယ်တန်းများ -
ခွင့်ပြုထားသော ပူဇော်သက္ခများကို သင်၏ကီးအတွက် ရရှိနိုင်သည်
country ID → service code → operator ID → reward (USD)

GETgetBalanceအသုံးပြုသူ၏ လက်ကျန်ငွေ

SMScash အတွက် အခြေအနေ - ရရှိသော အရည်အသွေးများကို အသုံးပြုခြင်း ၊

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=getBalance ကိုပို့ရန်

ဥပမာ တောင်းဆိုချက်

curl

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

package main

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

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

javascript

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

python

import requests

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

ဖြေကြား

လက်ကျန်ငွေ

ACCESS_BALANCE:0.00

getBalance လက်ရှိရှိကို ပြန်ရန် USD တန်ဖိုးဖြင့် 8 ဒေသနစ်အတွင်းများ
ဆိုင်းငံ့ကာလပြီးဆုံးသောငွေကိုသာ ထုတ်ယူနိုင်သည်။

GETgetHoldBalanceဆိုင်းငံ့ထားသောငွေ

SMS ရရှိပြီးနောက် ဝင်ငွေကို ပံ့ပိုးသူသတ်မှတ်ထားသည့်ကာလအထိ ဆိုင်းငံ့ထားသည်။ သတ်မှတ်ရက်ရောက်လျှင် ထိုငွေကို အလိုအလျောက်ထုတ်ယူနိုင်သည်။

ပရိုဂရမ်များ

ပရိုမ်ျက်	အမျိုးအစား	ဖော်ပြချက်
`api_key`*	string	အသုံးပြုသူ၏ ကိုယ်ပိုင် API ကီး။

* လိုအပ်သောပရိုဂရမ်။ တောင်းဆိုချက်များ အားလုံးတွင် လုပ်ဆောင်ချက်=getHoldBalance ကိုပို့ရန်

ဥပမာ တောင်းဆိုချက်

curl

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

package main

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

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

javascript

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

python

import requests

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

ဖြေကြား

ဆိုင်းငံ့ထားသောငွေ

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
ဆိုင်းငံ့ကာလပြီးဆုံးသောငွေကိုသာ ထုတ်ယူနိုင်သည်။

ဖြေဆိုချက် အက္ခရာများနှင့် တောင်းဆိုချက်များ

အထွင်း 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 ကီးကိုဖန်တီးပါ
`BAD_COUNTRY`	400	သို့မဟုတ် အခြေအနေ တစ်ခုခု မဟုတ်။getCountries မှ အမည် ယူပါ
`BAD_SESSION_DURATION`	400	အမှန်အကူအညီတဲ့ ဖော့မုန်နံပါတ်များကို ထုတ်ယူရန် 20 မိနစ်မှန်ပါ session_duration.
`BAD_REQUEST`	400	မမှန်ဘူး parameter သို့မဟုတ် Idempotency-Key.တောင်းဆိုချက်ကို ဖြတ်ပါ
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	အမည်မသိ သို့မဟုတ် ခွင့်ပြုထားသောဖိုင်တွဲအရာAPI ကုဒ်များကို ပြန်လည်ပြုလုပ်ပါ
`BAD_NUMBER`	200	စာမျက်နှာ အမျိုးအစားနံပါတ်ကို စာရင်းပေးပါ
`BAD_ACTION / BAD_STATUS`	200	အမည်မသိ အမိန့်ပေးချက်၊ အမည် သို့ လုပ်ဆောင်ချက်သတ်မှတ်ချက်များကို စစ်ဆေးပါ
`EMPTY_POOL`	200	ဆက်သွယ်ထားတဲ့ အခြေအနေ မရှိပါ။နောက်ပိုင်း ပြန်ပြောပါ 10-30 စက္ကန့် သို့ စစ်ထုတ်ချက်ပြောင်းပါ
`NUMBER_IN_USE`	200	ဥပမာ ၊သင်၏ဆက်ရှင်ကို ပြီးဆုံးပါ သို့မဟုတ် အခြားနံပါတ်ရွေးပါ
`NO_ACTIVATION`	200	ဆက်ရှင် သို့မဟုတ် ရှေ့နံပါတ်သည် သင်၏အကောင့်အတွက် မရှိပါ။အမည် နှင့် ကီးကို စစ်ဆေးပါ
`SESSION_CLOSED / SMS_REQUIRED`	200	အခြေအနေပြောင်းခြင်းကို လက်မရှိပါ။SMS ရဲ့ အခြေအနေ နဲ့ လက်ခံရန် စစ်ဆေးပါ
`SCOPE_BLOCKED`	200	ဥပမာ ၊API ကီး၏အပိုဒ်ကို အသစ်ပြုလုပ်ပါ
`IDEMPOTENCY_CONFLICT`	200	အကြံပြုချက် ကီး အခြားပရိုဂရမ်များနှင့် ဆက်သွယ်ပြီ။လုပ်ဆောင်ချက်အသစ်အတွက် အခြားတစ်ခုဖန်တီးပါ Idempotency-Key.
`BAD_REF / SELF_REF`	400	ဆော့ဝဲ အက္ခရာ ကုဒ်သည် အမည်မသိ၊ ခွင့်မဲ့ သို့မဟုတ် အသုံးပြုသူ၏ အဖြစ်ဖြစ်သည်။ဆော့ဝဲနဲ့ အခြေအနေ၏ အက္ခရာကို ပေးပါ
`INTERNAL_ERROR`	500	ယာယီ ဆာဗာ သို့မဟုတ် ရွေးချယ်မှုအမှားရှာဖွေခြင်းနှင့်တစ်ခုဖြင့် ပြန်ကြည့်ပါ Idempotency-Key.
`ALLOCATION_PENDING`	200	အရေအတွက် အခြေအနေကို တည်ဆောက်နေသည်။ တကယ်တစ်ခုကို ပြန်ကြိုးစားပါ Idempotency-Key.အရေအတွက် အခြေအနေကို တည်ဆောက်နေသည်။ တကယ်တစ်ခုကို ပြန်ကြိုးစားပါ Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	ဒုတိယ အရည်အသွေးကို မတည်ဆောက်ပါဘူး။ အလိုအလျောက်ကြားကြိုးစားခြင်းကို ခွဲခြားစေခြင်းငှါ ခွင့်ပြုခြင်းကို မပြုလုပ်နိုင်ပါ။ဒုတိယ အရည်အသွေးကို မတည်ဆောက်ပါဘူး။ အလိုအလျောက်ကြားကြိုးစားခြင်းကို ခွဲခြားစေခြင်းငှါ ခွင့်ပြုခြင်းကို မပြုလုပ်နိုင်ပါ။

REST ကူညီတစ်ခုကို ပြန်ရန် {"error":{"code":"…","message":"…"}} နိဂုံးတမ်း HTTP အခြေအနေများ 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "တောင်းဆိုမှု မြေပုံကို စစ်ဆေးပါ",
    "request_id": "req_…",
    "hint": "Use the documented JSON type; numbers must not be quoted.",
    "retryable": false,
    "details": {
      "field": "country",
      "expected": "integer"
    }
  }
}

REST

X-Request-ID: included in every API response
405: Allow lists the supported HTTP methods
ALLOCATION_PENDING: retryable=true · Retry-After=3 · same operation key
ALLOCATION_UNCERTAIN: retryable=false · contact support
Transport errors: check the operation before another write; keep the original key.

အဖွဲ့အစည်းအဝေးများအတွက်

USD ဒေါသတည်းဟူသော အရည်အသွေးများကို တည်ဆောက်ထားသည် 8 ဆယ်ဆယ်တန်းများ - 0.00300000 USD.

ငွေကြေးသည် USD. မေးခွန်းနှင့်ဖြေစာရွက်စာတမ်းများထဲမှာ ရရှိပါသည် OpenAPI.

ထွက်သွားပါ USDT · TRC20ငွေပေးချေမှုသည် 1 ရက်မှ 45 ရက်အထိ ကြာနိုင်သည်။ ငွေထုတ်ခမှာ 4 $ ဖြစ်ပြီး တောင်းဆိုထားသောပမာဏမှ နုတ်ယူသည်။ SMS ရရှိပြီးနောက် ဝင်ငွေကို ပံ့ပိုးသူသတ်မှတ်ထားသည့်ကာလအထိ ဆိုင်းငံ့ထားသည်။ သတ်မှတ်ရက်ရောက်လျှင် ထိုငွေကို အလိုအလျောက်ထုတ်ယူနိုင်သည်။ ဆိုင်းငံ့ကာလပြီးဆုံးသောငွေကိုသာ ထုတ်ယူနိုင်သည်။

GET/api/v1/catalogဝန်ဆောင်မှုများနှင့် နိုင်ငံများ

GET/api/v1/tariffsSMS ရည်ရွယ်ချက် အရောင်

GET/api/v1/offersဥပမာ ၊

GET/api/v1/servicesဖိုင်တွဲ

GET/api/v1/countriesဖိုင်တွဲ

GET/api/v1/operatorsဖိုင်တွဲ

GET/api/v1/availability?country=1အသုံးပြုရန်

POST/api/v1/activationsဆက်ရှင်အသစ်

GET/api/v1/activations/batch?ids=42,43နံပါတ်များစွာ စစ်ဆေးရန်

GET/api/v1/activationsနောက်ဆုံး 200 ဆက်ရှင်များ: scope=history, မျှော်လင့်ခြင်း သို့မဟုတ် အားလုံး

GET/api/v1/activations/{id}ဆက်ရှင်နှင့် စကားများ

GET/api/v1/activations/{id}/sms?after_id=0&limit=100အသစ် SMS ကုန်တာနှင့်

POST/api/v1/activations/{id}/retrySMS အတွက် ကြည့်ပါ

POST/api/v1/activations/{id}/finishအပြည့်အစုံ

POST/api/v1/activations/{id}/cancelရပ်တန့်

POST/api/v1/activations/repeatနံပါတ် ပြန်သွားပါ

GET/api/v1/keysAPI ကီးများ

POST/api/v1/keysကီးဖန်တီးပါ

PATCH/api/v1/keys/{id}အမည် သို့မဟုတ် ပရိုဂရမ်ပြောင်းပါ

DELETE/api/v1/keys/{id}ကီးကိုရုတ်ဖို့

GET/api/v1/referralsဥပမာ ၊

GET/api/v1/summaryနိဂုံးချုပ်နှံ့နှင့် အတိုင်းအစာ

GET/api/v1/balanceဆိုင်းငံ့ထားသောငွေ

GET/api/v1/ledgerဥပမာ ၊

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 ဥပမာ ၊