API Dokümantasyon

SMSOX hizmetlerini kendi yazılımına bağla.

Temel adres

Anahtarını X-API-Key başlığında (ya da api_key sorgu parametresinde) gönder. Tüm yanıtlar JSON'dur. Hatalarda "ok": false ile "code" ve "message" döner.

curl -H "X-API-Key: API_ANAHTARINIZ" https://demo3.colaksoftware.com.tr/api/v1/balance

GET/api/v1/balance

Nakit ve promosyon bakiyesi

{ "ok": true, "balance": 125.5, "promo": 10, "currency": "TRY" }

GET/api/v1/services

Tüm servisler ve başlangıç fiyatı

{ "ok": true, "services": [{ "code": "whatsapp", "name": "WhatsApp", "from_price": 18.5 }] }

GET/api/v1/countries?service=whatsapp

Ülke, fiyat ve stok

{ "ok": true, "countries": [{ "country": "TR", "name": "Türkiye", "price": 42.5, "stock": 120 }] }

POST/api/v1/order

Numara al. Gövde: {"service":"whatsapp","country":"TR","max_price":50}

{ "ok": true, "order": { "id": "k3x…", "phone": "905…", "price": 42.5, "status": "PENDING", "expires_at": "…" } }

GET/api/v1/order/{id}

Sipariş durumu ve SMS kodu

{ "ok": true, "order": { "status": "RECEIVED", "code": "482913", "sms_text": "…" } }

POST/api/v1/order/{id}/cancel

İptal ve iade

{ "ok": true, "order": { "status": "CANCELED" } }

POST/api/v1/order/{id}/finish

Tamamla

{ "ok": true, "order": { "status": "FINISHED" } }

POST/api/v1/order/{id}/retry

Yeni SMS iste

{ "ok": true }

GET/api/v1/orders?status=PENDING

Son siparişlerin

{ "ok": true, "orders": [ … ] }

SMS-Activate uyumlu uç nokta

Desteklenen işlemler: getBalance, getNumber, getNumberV2, getStatus, setStatus (8 iptal, 6 tamamla, 3 yeni kod), getPrices, getCountries, getServicesList. service = servis kodumuz (whatsapp) veya SMS-Activate kodu (wa); country = ISO kodu (TR) veya SMS-Activate ülke numarası.

https://demo3.colaksoftware.com.tr/stubs/handler_api.php?api_key=API_ANAHTARINIZ&action=getNumber&service=wa&country=TR
ACCESS_NUMBER:k3x9…:905xxxxxxxxx
https://demo3.colaksoftware.com.tr/stubs/handler_api.php?api_key=API_ANAHTARINIZ&action=getStatus&id=k3x9…
STATUS_OK:482913