v2 + v3

API dokümantasyonu

İki sürüm mevcut: v2 sektör standardıdır (mevcut betikleriniz değişmeden çalışır), v3 ise modern REST'tir (JSON, eşdeğerlik, imleçli sayfalama, 5 dil).

Adresler Hızlı başlangıç OpenAPI şeması Anahtar al

Bu herkese açık belgede fiyatlar ve hizmet kimlikleri gösterilmez: fiyat her müşteri için kendi fiyat grubuna göre hesaplanır. Kaydolduktan sonra panelde KENDİ kimlik ve fiyatlarınızla hazır bir örnek alırsınız.

Adresler

Kopyalamak için adrese tıklayın.

POST v2 açık

https://smmbilan.uz/api/v2

Kimlik doğrulama: gövdedeki `key` alanı

REST v3 açık

https://smmbilan.uz/api/v3

Kimlik doğrulama: `Authorization: Bearer <anahtar>`

İstek limiti: anahtar başına dakikada 600 istek. Eşdeğerlik anahtarı 24 saat saklanır.

Hızlı başlangıç

Dört adım — ilk isteğe kadar birkaç dakika.

Kaydolun ve panele giriş yapın.
"API anahtarları" bölümünde yeni bir anahtar oluşturun. Anahtar BİR KEZ gösterilir — hemen kaydedin.
Kataloğu isteyin ve ihtiyacınız olan hizmet ID'sini alın.
Siparişi gönderin. Durumu sorgulayarak veya webhook ile izleyin.

GET Katalog — v3

curl https://smmbilan.uz/api/v3/services \
  -H "Authorization: Bearer <KALITINGIZ>"

Kayıt ol Hizmetlere göz at

v2 — sektör standardı

POST önerilir. Eski GET/query uyumluluk için kabul edilir ama kullanımdan kaldırılmıştır. İş hatası HTTP 200 ve `{"error":"..."}` ile döner — bu standardın bir parçasıdır ve mevcut scriptler buna dayanır.

Eski GET/query uyumluluk için hâlâ kabul edilir ama kullanımdan kaldırılmıştır: URL'deki anahtar loglara ve tarayıcı geçmişine sızabilir. Yeni entegrasyonlarda POST gövdesini veya v3 Bearer kullanın.

POST https://smmbilan.uz/api/v2

curl -X POST https://smmbilan.uz/api/v2 \
  -d "key=<KALITINGIZ>" \
  -d "action=add" \
  -d "service=<XIZMAT_ID>" \
  -d "link=https://t.me/kanalim" \
  -d "quantity=1000"

# Javob: {"order": 100123}

POST action=balance — 200

Hesap bakiyesi. Bayiler genellikle her siparişten önce bunu çağırır.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=balance'

200 Yanıt

{
    "balance": "125.4000",
    "currency": "USD"
}

POST action=services — 200

Kataloğun tamamı. Sayfalama YOK, bu yüzden yanıt büyüktür — önbelleğe alın.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=services'

200 Yanıt

[
    {
        "service": "<XIZMAT_ID>",
        "name": "Telegram kanal a'zolari",
        "type": "Default",
        "category": "Telegram",
        "rate": "1.20000000",
        "min": "100",
        "max": "100000",
        "refill": true,
        "cancel": true,
        "dripfeed": true
    }
]

POST action=add service, link, quantity 200

Sipariş oluşturma. Yanıttaki `order` değeri sonraki isteklerde kullanılan numaradır.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=add' \
  -d 'service=<XIZMAT_ID>' \
  -d 'link=https://t.me/kanalim' \
  -d 'quantity=100'

200 Yanıt

{
    "order": 100123,
    "charge": "1.2000",
    "currency": "USD"
}

POST action=status order 200

Tek bir siparişin durumu. `remains` dahil tüm değerler METİNDİR.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=status' \
  -d 'order=100123'

200 Yanıt

{
    "charge": "1.2000",
    "start_count": "3572",
    "status": "In progress",
    "remains": "157",
    "currency": "USD"
}

POST action=status orders 200

Toplu durum: istek başına en fazla 100. Anahtarlar SORDUĞUNUZ ID'lerdir.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=status' \
  -d 'orders=100123,100124'

200 Yanıt

{
    "100123": {
        "charge": "1.2000",
        "start_count": "3572",
        "status": "Completed",
        "remains": "0",
        "currency": "USD"
    },
    "100124": {
        "error": "Incorrect order ID"
    }
}

POST action=refill order 200

Garanti talebi. Yanıttaki ID ile durumu `refill_status` üzerinden izleyin.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=refill' \
  -d 'order=100123'

200 Yanıt

{
    "refill": 5
}

POST action=refill_status refill 200

Garanti durumu. `Error` durumu da `Pending` olarak görünür — yeniden denemeler sürüyor.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=refill_status' \
  -d 'refill=5'

200 Yanıt

{
    "status": "Completed"
}

POST action=cancel orders 200

Bir iptal TALEBİ. `cancel: 1`, talebin kabul edildiği anlamına gelir; siparişin iptal edildiği anlamına GELMEZ.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=cancel' \
  -d 'orders=100123,100124'

200 Yanıt

[
    {
        "order": 100123,
        "cancel": 1
    },
    {
        "order": 100124,
        "cancel": {
            "error": "Incorrect order status"
        }
    }
]

POST action=special_services — 200

Özel hizmetler kataloğu: Telegram numarası, Stars, Premium. Fiyat BİR adet içindir; `services` içindeki `rate` ise 1000 adet içindir.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=special_services'

200 Yanıt

[
    {
        "variant": "12",
        "kind": "number",
        "slug": "UZ",
        "name": "O'zbekiston",
        "price": "1.2000",
        "currency": "USD",
        "dial_code": "+998",
        "stock": "35",
        "stars": null,
        "months": null,
        "recipient": false,
        "max_quantity": "10"
    }
]

POST action=special_add kind, variant, quantity, recipient 200

Özel sipariş. `kind` ve `variant` zorunlu; Stars ve Premium için `recipient` de gerekir. Yanıttaki `status` alanına dikkat edin: Stars ve Premium bakiye bekleyebilir.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=special_add' \
  -d 'kind=stars' \
  -d 'variant=31' \
  -d 'recipient=@mijoz_nomi'

200 Yanıt

{
    "order": 900123,
    "charge": "0.9900",
    "currency": "USD",
    "status": "Pending"
}

POST action=special_status order (yoki orders) 200

Tek bir özel sipariş — SMS kodu ve 2FA şifresi DAHİL. Toplu istekte (`orders=`) bu alanlar `null` olur.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=special_status' \
  -d 'order=900123'

200 Yanıt

{
    "charge": "1.2000",
    "status": "Completed",
    "currency": "USD",
    "kind": "number",
    "variant": "O'zbekiston",
    "quantity": "1",
    "recipient": null,
    "phone_number": "+998901234567",
    "refunded": "0.0000",
    "sms_code": "84921",
    "two_fa_password": null,
    "has_code": true
}

POST action=special_code order 200

Satın alınan numara için SMS kodu. Bunu YALNIZCA müşteri numarayı Telegram'a girdikten SONRA çağırın — kod birkaç dakika içinde geçersiz olur.

POST İstek

curl -X POST https://smmbilan.uz/api/v2 \
  -d 'key=<KALITINGIZ>' \
  -d 'action=special_code' \
  -d 'order=900123'

200 Yanıt

{
    "sms_code": "84921",
    "two_fa_password": null,
    "phone_number": "+998901234567",
    "attempts_left": "4"
}

200 İş hatası — HTTP 200 ile döner

{
    "error": "Not enough funds"
}

v3 — REST

Gerçek HTTP kodları, yapılandırılmış hata yanıtı, `X-Request-Id` başlığı ve 5 dilde hata mesajı (`Accept-Language`).

POST https://smmbilan.uz/api/v3/orders

curl -X POST https://smmbilan.uz/api/v3/orders \
  -H "Authorization: Bearer <KALITINGIZ>" \
  -H "Idempotency-Key: 3f9c1e40-…" \
  -H "Content-Type: application/json" \
  -d '{"service_id": <XIZMAT_ID>, "link": "https://t.me/kanalim", "quantity": 1000}'

`Idempotency-Key` sipariş verirken ZORUNLUDUR: ağ koptuğunda yeniden gönderseniz de ikinci bir sipariş oluşmaz ve para iki kez tahsil edilmez.

402 Hata yanıtı biçimi

{
    "error": {
        "code": "insufficient_balance",
        "message": "Balansingizda yetarli mablag' yo'q.",
        "details": {
            "required": "1.2000",
            "available": "0.3000"
        }
    },
    "request_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB"
}

Uç noktalar

GET /api/v3/me — 200

Anahtar ve hesap bilgisi. Entegrasyonu kurarken BİR KEZ çağrılır.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/me' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "user": {
            "username": "reseller1",
            "balance": "125.4000",
            "currency": "USD",
            "status": "active",
            "discount_percent": "5.00"
        },
        "api_key": {
            "name": "Ishlab chiqarish",
            "prefix": "smb_live_a1b2c3",
            "version": "v3",
            "sandbox": false,
            "scopes": [
                "balance:read",
                "services:read",
                "orders:read",
                "orders:write"
            ],
            "rate_limit_per_minute": 600,
            "expires_at": null
        },
        "capabilities": {
            "idempotency": true,
            "webhooks": true,
            "localization": true
        }
    }
}

GET /api/v3/balance balance:read 200

Hafif bir uç nokta: tek sorgu, ilişki yüklenmez.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/balance' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "balance": "125.4000",
        "currency": "USD",
        "total_spent": "874.2000",
        "total_deposited": "1000.0000"
    }
}

GET /api/v3/services services:read 200

İmleçli katalog. Sonraki istekte `next_cursor` değerini `after=` olarak gönderin.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/services?limit=100&after=0' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": [
        {
            "id": "<XIZMAT_ID>",
            "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
            "name": "Telegram kanal a'zolari",
            "description": null,
            "type": "default",
            "category": {
                "id": 3,
                "name": "Telegram"
            },
            "pricing": {
                "rate_per_1000": "1.20000000",
                "currency": "USD",
                "discount_percent": "5.00"
            },
            "quantity": {
                "min": 100,
                "max": 100000,
                "increment": 1,
                "from_input": false,
                "fixed": false
            },
            "features": {
                "refill": true,
                "refill_days": 30,
                "cancel": true,
                "dripfeed": true
            },
            "link_type": "link",
            "required_fields": [],
            "avg_time_seconds": 3600
        }
    ],
    "pagination": {
        "limit": 100,
        "has_more": true,
        "next_cursor": 148
    }
}

GET /api/v3/services/{id} services:read 200

Tek bir hizmet. `id` veya `public_id` (ULID) kabul edilir.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/services/<XIZMAT_ID>' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "id": "<XIZMAT_ID>",
        "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
        "name": "Telegram kanal a'zolari",
        "description": null,
        "type": "default",
        "category": {
            "id": 3,
            "name": "Telegram"
        },
        "pricing": {
            "rate_per_1000": "1.20000000",
            "currency": "USD",
            "discount_percent": "5.00"
        },
        "quantity": {
            "min": 100,
            "max": 100000,
            "increment": 1,
            "from_input": false,
            "fixed": false
        },
        "features": {
            "refill": true,
            "refill_days": 30,
            "cancel": true,
            "dripfeed": true
        },
        "link_type": "link",
        "required_fields": [],
        "avg_time_seconds": 3600
    }
}

POST /api/v3/orders orders:write 201

Sipariş oluşturma. `Idempotency-Key` başlığı ZORUNLUDUR.

POST İstek

curl -X POST 'https://smmbilan.uz/api/v3/orders' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json' \
  -H 'Idempotency-Key: 8f14e45fceea167a5a36dedd4bea2543' \
  -H 'Content-Type: application/json' \
  -d '{"service_id":"<XIZMAT_ID>","link":"https://t.me/kanalim","quantity":100}'

201 Yanıt

{
    "data": {
        "id": 100123,
        "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
        "service": {
            "id": "<XIZMAT_ID>",
            "name": "Telegram kanal a'zolari",
            "type": "default"
        },
        "link": "https://t.me/kanalim",
        "quantity": 100,
        "status": "pending",
        "charge": "1.2000",
        "currency": "USD",
        "start_count": null,
        "remains": null,
        "delivered": 0,
        "progress_percent": 0,
        "refunded": "0.0000",
        "dripfeed": null,
        "refill_available": false,
        "created_at": "2026-08-31T09:14:02+00:00",
        "completed_at": null
    }
}

GET /api/v3/orders orders:read 200

TERS imleçli siparişler (`before=`) — en yenisi önce. Sistemin oluşturduğu alt siparişler hariç tutulur.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/orders?limit=50' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": [
        {
            "id": 100123,
            "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
            "service": {
                "id": "<XIZMAT_ID>",
                "name": "Telegram kanal a'zolari",
                "type": "default"
            },
            "link": "https://t.me/kanalim",
            "quantity": 100,
            "status": "pending",
            "charge": "1.2000",
            "currency": "USD",
            "start_count": null,
            "remains": null,
            "delivered": 0,
            "progress_percent": 0,
            "refunded": "0.0000",
            "dripfeed": null,
            "refill_available": false,
            "created_at": "2026-08-31T09:14:02+00:00",
            "completed_at": null
        }
    ],
    "pagination": {
        "limit": 50,
        "has_more": false,
        "next_cursor": null
    }
}

GET /api/v3/orders/{id} orders:read 200

Tek bir sipariş. `number` veya `public_id` kabul edilir.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/orders/100123' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "id": 100123,
        "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
        "service": {
            "id": "<XIZMAT_ID>",
            "name": "Telegram kanal a'zolari",
            "type": "default"
        },
        "link": "https://t.me/kanalim",
        "quantity": 100,
        "status": "pending",
        "charge": "1.2000",
        "currency": "USD",
        "start_count": null,
        "remains": null,
        "delivered": 0,
        "progress_percent": 0,
        "refunded": "0.0000",
        "dripfeed": null,
        "refill_available": false,
        "created_at": "2026-08-31T09:14:02+00:00",
        "completed_at": null
    }
}

POST /api/v3/orders/{id}/refill orders:write 202

Garanti talebi. 202, kabul edildi ama henüz tamamlanmadı demektir.

POST İstek

curl -X POST 'https://smmbilan.uz/api/v3/orders/100123/refill' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

202 Yanıt

{
    "data": {
        "id": 5,
        "order_id": 100123,
        "status": "pending",
        "quantity": null,
        "charge": "0.0000",
        "is_paid": false,
        "reason": null,
        "created_at": "2026-08-31T09:14:02+00:00",
        "completed_at": null
    }
}

POST /api/v3/orders/{id}/cancel orders:write 202

İptal talebi. Yanıtta siparişin GÜNCELLENMİŞ durumu da gelir.

POST İstek

curl -X POST 'https://smmbilan.uz/api/v3/orders/100123/cancel' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

202 Yanıt

{
    "data": {
        "accepted": true,
        "approval_status": "pending",
        "order": {
            "id": 100123,
            "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
            "service": {
                "id": "<XIZMAT_ID>",
                "name": "Telegram kanal a'zolari",
                "type": "default"
            },
            "link": "https://t.me/kanalim",
            "quantity": 100,
            "status": "pending",
            "charge": "1.2000",
            "currency": "USD",
            "start_count": null,
            "remains": null,
            "delivered": 0,
            "progress_percent": 0,
            "refunded": "0.0000",
            "dripfeed": null,
            "refill_available": false,
            "created_at": "2026-08-31T09:14:02+00:00",
            "completed_at": null
        }
    }
}

GET /api/v3/refills/{id} orders:read 200

Garanti durumu.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/refills/5' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "id": 5,
        "order_id": 100123,
        "status": "pending",
        "quantity": null,
        "charge": "0.0000",
        "is_paid": false,
        "reason": null,
        "created_at": "2026-08-31T09:14:02+00:00",
        "completed_at": null
    }
}

GET /api/v3/special/services services:read 200

Özel hizmetler kataloğu. Sayfalama YOK — yalnızca üç bölüm var. `price` BİR adet içindir.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/special/services' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": [
        {
            "kind": "stars",
            "label": "Telegram Stars",
            "description": "Telegram Stars paketlari",
            "accepting_orders": true,
            "freeze_reason": null,
            "requires_recipient": true,
            "supports_quantity": false,
            "max_quantity": 1,
            "delivers_sms_code": false,
            "variants": [
                {
                    "id": 31,
                    "slug": "50",
                    "label": "50 Stars",
                    "price": "0.9900",
                    "currency": "USD",
                    "dial_code": null,
                    "stock": null,
                    "stars": 50,
                    "months": null
                }
            ]
        }
    ]
}

POST /api/v3/special/orders orders:write 201

Özel sipariş. `Idempotency-Key` ZORUNLUDUR. Stars ve Premium için `recipient` gereklidir.

POST İstek

curl -X POST 'https://smmbilan.uz/api/v3/special/orders' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json' \
  -H 'Idempotency-Key: 8f14e45fceea167a5a36dedd4bea2543' \
  -H 'Content-Type: application/json' \
  -d '{"kind":"stars","variant_id":31,"recipient":"mijoz_nomi"}'

201 Yanıt

{
    "data": {
        "id": 900123,
        "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
        "kind": "stars",
        "variant": {
            "id": 31,
            "label": "50 Stars",
            "country_code": null,
            "dial_code": null,
            "stars": 50,
            "months": null
        },
        "recipient": "mijoz_nomi",
        "quantity": 1,
        "status": "pending",
        "charge": "0.9900",
        "currency": "USD",
        "refunded": "0.0000",
        "delivery": {
            "phone_number": null,
            "sms_code": null,
            "two_fa_password": null,
            "has_code": false
        },
        "code_available": false,
        "code_attempts_left": 0,
        "waiting_for_funds": false,
        "created_at": "2026-08-31T09:14:02+00:00",
        "completed_at": null
    }
}

GET /api/v3/special/orders orders:read 200

Özel siparişler, imleç GERİYE gider (`before=`). LİSTEDE SMS kodu ve 2FA şifresi HER ZAMAN `null` olur — `has_code` alanına bakıp siparişi tek tek isteyin.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/special/orders?limit=50' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": [
        {
            "id": 900123,
            "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
            "kind": "stars",
            "variant": {
                "id": 31,
                "label": "50 Stars",
                "country_code": null,
                "dial_code": null,
                "stars": 50,
                "months": null
            },
            "recipient": "mijoz_nomi",
            "quantity": 1,
            "status": "pending",
            "charge": "0.9900",
            "currency": "USD",
            "refunded": "0.0000",
            "delivery": {
                "phone_number": null,
                "sms_code": null,
                "two_fa_password": null,
                "has_code": false
            },
            "code_available": false,
            "code_attempts_left": 0,
            "waiting_for_funds": false,
            "created_at": "2026-08-31T09:14:02+00:00",
            "completed_at": null
        }
    ],
    "pagination": {
        "limit": 50,
        "has_more": false,
        "next_cursor": null
    }
}

GET /api/v3/special/orders/{id} orders:read 200

Tek bir özel sipariş — GİZLİ BİLGİLERLE. `number` (900000'den itibaren) veya `public_id` kabul edilir.

GET İstek

curl -X GET 'https://smmbilan.uz/api/v3/special/orders/900123' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "id": 900123,
        "public_id": "01K3XZQ8V4N7Y2M9P6R1T5W0AB",
        "kind": "number",
        "variant": {
            "id": 12,
            "label": "O'zbekiston",
            "country_code": "UZ",
            "dial_code": "+998",
            "stars": null,
            "months": null
        },
        "recipient": null,
        "quantity": 1,
        "status": "completed",
        "charge": "1.2000",
        "currency": "USD",
        "refunded": "0.0000",
        "delivery": {
            "phone_number": "+998901234567",
            "sms_code": "84921",
            "two_fa_password": null,
            "has_code": true
        },
        "code_available": true,
        "code_attempts_left": 4,
        "waiting_for_funds": false,
        "created_at": "2026-08-31T09:14:02+00:00",
        "completed_at": "2026-08-31T09:15:40+00:00"
    }
}

POST /api/v3/special/orders/{id}/code orders:write 200

Numara için SMS kodu. Her çağrı bir deneme harcar — başarısız olanlar dahil. `Idempotency-Key` burada KABUL EDİLMEZ: yanıt hesap erişim bilgilerini içerir.

POST İstek

curl -X POST 'https://smmbilan.uz/api/v3/special/orders/900123/code' \
  -H 'Authorization: Bearer <KALITINGIZ>' \
  -H 'Accept: application/json'

200 Yanıt

{
    "data": {
        "phone_number": "+998901234567",
        "sms_code": "84921",
        "two_fa_password": null,
        "attempts_left": 4
    }
}

OpenAPI 3.1 spesifikasyonu: /api/v3/openapi.json — anahtar olmadan açılır. Postman veya Insomnia'ya aktarın ya da bir kod üreticisiyle istemci kütüphanesi oluşturun.

Sipariş durumları

Durum haritası
v3	v2	Not
pending	Pending	Bekliyor
awaiting	Pending	Sırada
in_progress	In progress	İşlemde
processing	Processing	İşleniyor
completed	Completed	Tamamlandı
partial	Partial	Kısmi
canceled	Canceled	İptal edildi
refunded	Canceled	İade edildi
failed	Canceled	Başarısız

Dikkat: v2'de `refunded` ve `failed` ayrı durumlar olarak YOK — ikisi de `Canceled` olarak görünür.

Hizmet türleri ve zorunlu alanlar

Hizmet türleri
v3	v2	Ek alanlar	Miktar
default	Default	—	siz gönderirsiniz
package	Package	—	sabit (min. = maks.)
custom_comments	Custom Comments	comments	girişten itibaren sayılır
custom_comments_package	Custom Comments Package	comments	sabit (min. = maks.)
mentions	Mentions	usernames	girişten itibaren sayılır
mentions_hashtags	Mentions with Hashtags	hashtags	siz gönderirsiniz
mentions_custom	Mentions Custom List	usernames	girişten itibaren sayılır
mentions_followers	Mentions User Followers	username	siz gönderirsiniz
mentions_likers	Mentions Likers	username	siz gönderirsiniz
mentions_media_likers	Mentions Media Likers	media_url	siz gönderirsiniz
subscriptions	Subscriptions	username	siz gönderirsiniz
poll	Poll	answer_number	siz gönderirsiniz
invites	Invites	groups	siz gönderirsiniz
comment_likes	Comment Likes	username	siz gönderirsiniz

v3 hata kodları

Hata kodları
Kod	HTTP	Ne oldu
invalid_api_key	401	Anahtar geçersiz, süresi dolmuş veya iptal edilmiş.
wrong_api_version	401	v2 anahtarıyla v3'e (veya tersine) erişim.
account_blocked	403	Hesap askıya alınmış veya engellenmiş.
api_disabled_for_account	403	Bu hesapta API kapalı — lütfen desteğe yazın.
insufficient_scope	403	Anahtarda gereken izin yok. `details.required_scope` değerine bakın.
not_found	404	Kayıt bulunamadı veya size ait değil.
idempotency_key_required	422	`Idempotency-Key` başlığı gönderilmedi. Sipariş verirken ZORUNLUDUR.
idempotency_in_progress	409	Aynı anahtarla gelen istek hâlâ işleniyor. 1-2 saniye sonra tekrar deneyin.
idempotency_key_reused	409	Aynı anahtar farklı bir işlem, rota parametresi veya gövde ile gönderildi. Her işlem için yeni bir anahtar üretin.
validation_failed	422	İstek alanları geçersiz.
order_rejected	422	Sipariş reddedildi. Nedeni `details.reason` içinde.
refill_rejected	422	Garanti talebi reddedildi. Nedeni `details.reason` içinde.
insufficient_balance	402	Bakiye yetersiz. Gerekli ve mevcut tutarlar `details` içinde.
rate_limited	429	İstek limiti aşıldı. `Retry-After` başlığındaki süre kadar bekleyin.
api_version_disabled	503	API geçici olarak kapatıldı. Lütfen tekrar deneyin.
sandbox_read_only	403	Test anahtarı veriyi değiştiremez.

Anahtarınızı bugün alın

Kayıt ücretsizdir. Anahtar oluşturulduğunda panelde KENDİ hizmet ID'leriniz ve fiyatlarınızla hazır bir örnek görürsünüz.

Kayıt ol OpenAPI şeması