Nomor untuk menerima SMS — langsung dari software Anda

Mulai cepat

1. Masuk ke akun dan buka Saldo → API → Buat kunci. Kunci hanya ditampilkan sekali — simpan baik-baik.
2. Isi saldo hingga $20 atau lebih: pembelian lewat API hanya berjalan dengan saldo itu. Menyimpan kunci dengan saldo nol tidak masalah.
3. Atur server https://relysms.pro/stubs/handler_api.php di software Anda dan pakai kunci Anda sebagai ganti kunci layanan sebelumnya.
4. Beli nomor (getNumber), lalu cek status setiap 5–10 detik (getStatus) sampai muncul STATUS_OK beserta kodenya.
5. Selesaikan pesanan (setStatus=6). Jika kode tidak masuk, batalkan setelah 2 menit (setStatus=8) atau tunggu sampai jendela waktu habis: uang kembali otomatis.

Aturan & batas

• Pembelian lewat API memerlukan saldo minimal $20. Di bawah itu, getNumber menjawab NO_BALANCE; metode lain tetap berjalan.
• Nomor milik Anda selama 20 menit. Tidak ada kode — pesanan tertutup sendiri dan uang kembali ke saldo.
• Pesanan bisa dibatalkan 2 menit setelah dibeli jika kode belum masuk. Uang langsung kembali.
• Begitu kode pertama masuk, pesanan dianggap lunas dan tidak dikembalikan. Selama jendela waktu masih terbuka, kode berikutnya masih bisa masuk.
• Maksimal 20 permintaan dan 5 pembelian per detik per kunci; maksimal 50 pesanan terbuka sekaligus.
• Harga dikunci saat pembelian. maxPrice mencegah pembelian di atas batas Anda.
• Ketentuan layanan berlaku: spam, penipuan, dan pendaftaran massal untuk tujuan itu dilarang.

Metode

Setiap permintaan berupa GET atau POST ke satu alamat, dengan parameter di query string atau body formulir. Kunci dikirim di api_key, aksinya di action.

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getBalance

ACCESS_BALANCE:25.00

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getNumber&service=tg&country=187&maxPrice=0.80

ACCESS_NUMBER:1042:15550001111

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getNumberV2&service=tg&country=187&maxPrice=0.80

{
  "activationId": 1042,
  "phoneNumber": "15550001111",
  "activationCost": 0.59,
  "countryCode": "187",
  "canGetAnotherSms": true,
  "activationTime": "2026-10-27T10:00:00.000Z",
  "activationEndTime": "2026-10-27T10:20:00.000Z"
}

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getStatus&id=1042

STATUS_OK:48213

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=setStatus&id=1042&status=6

ACCESS_ACTIVATION

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getActiveActivations

{
  "status": "success",
  "activeActivations": [
    {
      "activationId": 1042,
      "serviceCode": "tg",
      "phoneNumber": "15550001111",
      "activationCost": 0.59,
      "activationStatus": "2",
      "smsCode": ["48213"],
      "smsText": ["Telegram code: 48213"],
      "activationTime": "2026-10-27T10:00:00.000Z",
      "countryCode": "187"
    }
  ]
}

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getPrices&service=tg&country=187

{ "187": { "tg": { "cost": 0.59, "count": 1000 } } }

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getCountries

{ "187": { "id": 187, "rus": "США", "eng": "United States", "visible": 1 } }

GET https://relysms.pro/stubs/handler_api.php?api_key=KEY&action=getServicesList

{ "status": "success", "services": [{ "code": "tg", "name": "Telegram" }] }

Status

Nilai status pada setStatus:

• status=1 → ACCESS_READY — Nomor sudah dimasukkan ke layanan, menunggu kode. Tidak mengubah apa pun; dipertahankan demi kompatibilitas.
• status=3 → ACCESS_RETRY_GET — Minta kode lain ke nomor yang sama — setelah kode pertama, selama pesanan terbuka. Gratis. Sampai kode itu datang, getStatus menjawab STATUS_WAIT_RETRY.
• status=6 → ACCESS_ACTIVATION — Selesaikan pesanan setelah kode masuk. Tidak ada SMS baru yang akan masuk ke nomor itu.
• status=8 → ACCESS_CANCEL — Batalkan pesanan tanpa kode (paling cepat setelah 2 menit). Uang kembali ke saldo.

Jawaban getStatus:

• STATUS_WAIT_CODE — Kode belum masuk — tanyakan lagi 5–10 detik kemudian.
• STATUS_OK:48213 — Kode sudah masuk; setelah titik dua adalah kodenya (atau teks SMS jika tidak berisi kode).
• STATUS_WAIT_RETRY:48213 — Kode lain sudah diminta dan belum datang; setelah titik dua adalah kode sebelumnya.
• STATUS_CANCEL — Dibatalkan atau ditutup tanpa kode; uang sudah kembali ke saldo.

Error

Error dikirim sebagai teks biasa, seperti lazimnya protokol ini. Semua, kecuali RATE_LIMIT, dengan status 200.

Kode layanan & negara

Kodenya adalah kode standar protokol: tg — Telegram, wa — WhatsApp, dan seterusnya; negara 187 — AS. getServicesList dan getCountries memberi daftar lengkap — ambil kode dari sana, bukan dari tabel lama: layanan dan negara berubah sesuai stok.

REST API v1

Nomor dan aturan yang sama dengan handler_api.php, dalam JSON: layanan dengan nama (telegram), negara dengan kode ISO (US), status HTTP, dan kode error yang mudah dipakai program untuk bercabang. Pakai ini untuk kode baru; biarkan handler_api.php untuk software yang sudah memakainya.

https://relysms.pro/api/v1

Webhook

Daripada mengecek GET /orders/{id} terus, atur alamat HTTPS lewat PUT /webhook dan kami akan mengirim POST ke sana saat ada perubahan pada pesanan yang dibeli lewat API. Isinya adalah pesanan sebagaimana saat dikirim. Balas dengan 2xx apa pun dalam 10 detik; satu pesanan bisa menghasilkan beberapa event, dan event yang sama bisa datang dua kali setelah pengulangan, jadi gunakan id pengiriman.

• order.code_received — Kode datang (setiap kode baru mengirim ini lagi).
• order.finished — Pesanan selesai — oleh Anda, atau saat waktunya habis setelah ada kode.
• order.cancelled — Dibatalkan tanpa kode; uang kembali ke saldo.
• order.expired — Waktu habis tanpa kode; uang kembali ke saldo.
• ping — Uji dari POST /webhook/test; order bernilai null.

POST /relysms-hook HTTP/1.1
Content-Type: application/json
X-RelySMS-Event: order.code_received
X-RelySMS-Delivery: cm…
X-RelySMS-Signature: t=1793095272,v1=5f2b…

{
  "id": "cm…",
  "event": "order.code_received",
  "createdAt": "2026-10-27T10:01:12.000Z",
  "order": { "id": 1042, "status": "received", "codes": [{ "code": "48213", … }], … }
}

Setiap permintaan membawa X-RelySMS-Signature: t=<waktu unix>,v1=<tanda tangan>. Tanda tangannya adalah HMAC-SHA256 dari string "t.body" (body mentah, byte demi byte) dengan secret webhook Anda, dalam hex. Periksa tanda tangan itu, dan bahwa t tidak lebih dari 5 menit, sebelum memercayai isinya.

Python

import hashlib, hmac, time

def verify(secret: str, body: bytes, header: str, tolerance=300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    t, sig = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > tolerance:
        return False
    expected = hmac.new(secret.encode(), f"{t}.".encode() + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)

Node.js

import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(secret, rawBody, header, tolerance = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=", 2)));
  const t = Number(parts.t);
  if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > tolerance) return false;
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return expected.length === parts.v1?.length && timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}

Jika server Anda tidak membalas 2xx, kami mengulang setelah 10 detik, 1 menit, 5 menit, 30 menit, 2 jam, dan 6 jam — total 7 percobaan — lalu berhenti. GET /webhook/deliveries menunjukkan apa yang terkirim dan yang gagal.

Endpoint

curl -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/balance

{ "balance": 25, "currency": "USD", "canBuy": true, "apiMinimum": 20 }

curl -H "Authorization: Bearer $KEY" "https://relysms.pro/api/v1/services?lang=en"

{ "services": [{ "id": "telegram", "name": "Telegram", "protocolCode": "tg" }] }

curl -H "Authorization: Bearer $KEY" "https://relysms.pro/api/v1/countries?lang=en"

{ "countries": [{ "id": "US", "name": "United States", "protocolCode": 187 }] }

curl -H "Authorization: Bearer $KEY" "https://relysms.pro/api/v1/prices?service=telegram"

{ "prices": [{ "service": "telegram", "country": "US", "price": 0.59, "stock": 1000 }] }

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7c1f0e2a-run-1" \
  -d '{"service":"telegram","country":"US","maxPrice":0.8}' \
  https://relysms.pro/api/v1/orders

{
  "order": {
    "id": 1042,
    "service": "telegram",
    "country": "US",
    "phone": "15550001111",
    "price": 0.59,
    "status": "waiting",
    "refunded": false,
    "codes": [],
    "awaitingAnotherCode": false,
    "createdAt": "2026-10-27T10:00:00.000Z",
    "expiresAt": "2026-10-27T10:20:00.000Z",
    "cancelableAt": "2026-10-27T10:02:00.000Z"
  }
}

curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7c1f0e2a-batch-1" \
  -d '{"service":"telegram","country":"US","quantity":5}' \
  https://relysms.pro/api/v1/orders/batch

{
  "orders": [{ "id": 1043, "phone": "15550001112", … }, { "id": 1044, … }],
  "requested": 5,
  "placed": 2,
  "stoppedBy": { "code": "no_numbers", "message": "…" }
}

curl -H "Authorization: Bearer $KEY" "https://relysms.pro/api/v1/orders?status=all&limit=50"

{ "orders": [{ "id": 1042, … }], "next": "1001" }

curl -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/orders/1042

{
  "order": {
    "id": 1042,
    "status": "received",
    "codes": [{ "code": "48213", "text": "Telegram code: 48213", "receivedAt": "2026-10-27T10:01:12.000Z" }],
    …
  }
}

curl -X POST -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/orders/1042/finish

{ "order": { "id": 1042, "status": "finished", … } }

curl -X POST -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/orders/1042/another-code

{ "order": { "id": 1042, "status": "received", "awaitingAnotherCode": true, … } }

curl -X POST -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/orders/1042/cancel

{ "order": { "id": 1042, "status": "cancelled", "refunded": true, … } }

curl -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/webhook

{ "webhook": { "url": "https://example.com/relysms-hook", "secret": "whsec_…", "createdAt": "2026-10-27T10:00:00.000Z" } }

curl -X PUT -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/relysms-hook"}' \
  https://relysms.pro/api/v1/webhook

{ "webhook": { "url": "https://example.com/relysms-hook", "secret": "whsec_…", "createdAt": "2026-10-27T10:00:00.000Z" } }

curl -X DELETE -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/webhook

{ "webhook": null }

curl -X POST -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/webhook/test

{ "delivery": { "id": "cm…" } }

curl -H "Authorization: Bearer $KEY" https://relysms.pro/api/v1/webhook/deliveries

{
  "deliveries": [{
    "id": "cm…", "event": "order.code_received", "orderId": 1042,
    "status": "pending", "attempts": 2, "lastHttpStatus": 502, "lastError": "HTTP 502",
    "createdAt": "2026-10-27T10:01:12.000Z", "deliveredAt": null, "nextAttemptAt": "2026-10-27T10:02:22.000Z"
  }]
}

Status pesanan

Kolom status pada pesanan:

• waiting — Nomor milik Anda dan belum ada kode.
• received — Kode sudah datang; ada di codes. Kode lain bisa datang selama pesanan terbuka.
• finished — Anda menyelesaikan pesanan (atau waktunya habis setelah ada kode).
• cancelled — Dibatalkan tanpa kode; refunded bernilai true dan uang ada di saldo.
• expired — Waktu habis tanpa kode; uang kembali ke saldo.

Error

Error berupa status HTTP dan JSON dengan code untuk program dan message untuk manusia. Sebagian membawa kolom tambahan (price, cancelableAt, apiMinimum).

{ "error": { "code": "price_above_max", "message": "The price is above maxPrice.", "price": 0.59 } }

Contoh REST

Beli nomor, tunggu kode, selesaikan pesanan.

Python

import time, uuid, requests

BASE = "https://relysms.pro/api/v1"
S = requests.Session()
S.headers["Authorization"] = "Bearer rs_your_key"

r = S.post(f"{BASE}/orders",
           json={"service": "telegram", "country": "US", "maxPrice": 0.8},
           headers={"Idempotency-Key": str(uuid.uuid4())}, timeout=30)
if r.status_code != 201:
    raise SystemExit(r.json()["error"])   # no_numbers, below_api_minimum, …
order = r.json()["order"]
print("number:", order["phone"])

while order["status"] == "waiting":       # up to 20 minutes
    time.sleep(10)
    order = S.get(f"{BASE}/orders/{order['id']}", timeout=30).json()["order"]

if order["status"] == "received":
    print("code:", order["codes"][-1]["code"])
    S.post(f"{BASE}/orders/{order['id']}/finish", timeout=30)
# "expired" or "cancelled": the money is back on the balance

Node.js

const BASE = "https://relysms.pro/api/v1";
const headers = { Authorization: "Bearer rs_your_key", "Content-Type": "application/json" };

const res = await fetch(`${BASE}/orders`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({ service: "telegram", country: "US", maxPrice: 0.8 }),
});
if (res.status !== 201) throw new Error((await res.json()).error.code);
let { order } = await res.json();
console.log("number:", order.phone);

while (order.status === "waiting") {
  await new Promise((r) => setTimeout(r, 10_000));
  ({ order } = await (await fetch(`${BASE}/orders/${order.id}`, { headers })).json());
}
if (order.status === "received") {
  console.log("code:", order.codes.at(-1).code);
  await fetch(`${BASE}/orders/${order.id}/finish`, { method: "POST", headers });
}

Contoh

Siklus lengkap: beli nomor, tunggu kode, selesaikan pesanan.

curl

KEY=rs_your_key
BASE=https://relysms.pro/stubs/handler_api.php

curl "$BASE?api_key=$KEY&action=getBalance"
curl "$BASE?api_key=$KEY&action=getNumber&service=tg&country=187&maxPrice=0.80"
# → ACCESS_NUMBER:1042:15550001111
curl "$BASE?api_key=$KEY&action=getStatus&id=1042"
# → STATUS_WAIT_CODE … then STATUS_OK:48213
curl "$BASE?api_key=$KEY&action=setStatus&id=1042&status=6"

Python

import time, requests

BASE = "https://relysms.pro/stubs/handler_api.php"
KEY = "rs_your_key"

def call(action, **params):
    r = requests.get(BASE, params={"api_key": KEY, "action": action, **params}, timeout=30)
    r.raise_for_status()
    return r.text

answer = call("getNumber", service="tg", country="187", maxPrice="0.80")
if not answer.startswith("ACCESS_NUMBER"):
    raise SystemExit(answer)          # NO_NUMBERS, NO_BALANCE, …
_, order_id, phone = answer.split(":")
print("number:", phone)

for _ in range(120):                  # up to 20 minutes, every 10 s
    status = call("getStatus", id=order_id)
    if status.startswith("STATUS_OK:"):
        print("code:", status.split(":", 1)[1])
        call("setStatus", id=order_id, status=6)
        break
    if status == "STATUS_CANCEL":
        break                         # refunded automatically
    time.sleep(10)

Node.js

const BASE = "https://relysms.pro/stubs/handler_api.php";
const KEY = "rs_your_key";

async function call(action, params = {}) {
  const url = new URL(BASE);
  url.search = new URLSearchParams({ api_key: KEY, action, ...params });
  const res = await fetch(url);
  return res.text();
}

const answer = await call("getNumber", { service: "tg", country: "187", maxPrice: "0.80" });
if (!answer.startsWith("ACCESS_NUMBER")) throw new Error(answer);
const [, id, phone] = answer.split(":");
console.log("number:", phone);

for (let i = 0; i < 120; i++) {
  const status = await call("getStatus", { id });
  if (status.startsWith("STATUS_OK:")) {
    console.log("code:", status.slice("STATUS_OK:".length));
    await call("setStatus", { id, status: "6" });
    break;
  }
  if (status === "STATUS_CANCEL") break; // refunded automatically
  await new Promise((r) => setTimeout(r, 10_000));
}

Pertanyaan

Untuk asisten AI

Dokumentasi lengkap dalam satu teks untuk ChatGPT, Claude, dan model lain ada di /id/developers.md, dan peta singkatnya di /llms.txt. Berikan tautannya kepada model dan minta model menghubungkan RelySMS ke kode Anda.

Baca https://relysms.pro/id/developers.md dan hubungkan RelySMS ke skrip saya.

developers.md · llms.txt