Bayi API

Tek bir uç nokta, key ve action alanlarını taşıyan bir form. Standart SMM panel API v2 ile uyumludur — hazır mağaza ve faturalama modülleri değişiklik gerektirmeden bağlanır.

Hızlı başlangıç

Adres: https://telegos.app/api/v2
Metot: POST
Gövde biçimi: application/x-www-form-urlencoded
Yanıt: JSON, her zaman status ile 200

Anahtar, istek gövdesinin key alanında iletilir — Authorization başlığı burada kullanılmaz. Hesabınız ayrı bir token ile çalışır, bu yüzden anahtarı sıfırlamak tarayıcı oturumunuzu kapatmaz.

Hizmet listesi

Tüm fiyat listesini döndürür: action=add için hizmet id’si, 1000 adet başına fiyat ve hacim sınırları.

Alan	Değer
`key`	Anahtarınız
`action`	services

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=services

Yanıt

[
  {
    "service": 101,
    "name": "Telegram Members · CIS",
    "type": "Default",
    "category": "Telegram Members",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Sipariş oluştur

Bakiyeden hemen düşer ve sipariş numarasını döndürür.

Alan	Değer
`key`	Anahtarınız
`action`	add
`service`	action=services çıktısındaki hizmet id’si
`link`	Kanal, gönderi veya profil bağlantısı
`quantity`	min…max aralığındaki sipariş hacmi

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=500

Yanıt

{
  "order": 23501
}

Aralıklı sipariş

Aynı alanlar ve iki tane daha: kaç gönderim yapılacağı ve aralarındaki bekleme. Burada quantity tek bir gönderimin hacmidir ve tüm gönderimlerin toplamı tahsil edilir.

Alan	Değer
`runs`	Gönderim sayısı
`interval`	Gönderimler arası bekleme, dakika

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=101 \
  -d link=https://t.me/example \
  -d quantity=100 \
  -d runs=5 \
  -d interval=60

Yanıt

{
  "order": 23502
}

Sipariş durumu

start_count başlangıçtaki sayaçtır, remains ise henüz teslim edilmemiş miktardır.

Alan	Değer
`key`	Anahtarınız
`action`	status
`order`	Sipariş numarası

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=23501

Yanıt

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

Birkaç siparişin durumu

İstek başına en fazla 100 numara. Yanıt, sipariş numaralarıyla anahtarlanmış bir nesnedir: bulunamayan numara error ile gelir ve diğerlerini bozmaz.

Alan	Değer
`key`	Anahtarınız
`action`	status
`orders`	Virgülle ayrılmış numaralar

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=23501,23502,999999

Yanıt

{
  "23501": {
    "charge": "0.4500",
    "start_count": "3572",
    "status": "Completed",
    "remains": "0",
    "currency": "USD"
  },
  "23502": {
    "charge": "0.9000",
    "start_count": "1204",
    "status": "In progress",
    "remains": "300",
    "currency": "USD"
  },
  "999999": {
    "error": "Incorrect order ID"
  }
}

Yenileme

Hizmetin refill: true döndürdüğü yerlerde kullanılabilir. Yenilemenin durumu, numarası ile ayrı bir refill_status işlemiyle sorgulanır.

Alan	Değer
`key`	Anahtarınız
`action`	refill / refill_status
`order`	Sipariş numarası — refill için
`refill`	Yenileme numarası — refill_status için

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=23501

Yanıt

{
  "refill": 412
}

İptal

Hizmetin cancel: true döndürdüğü yerlerde kullanılabilir. İptal edilen siparişlerin tutarı bakiyeye döner.

Alan	Değer
`key`	Anahtarınız
`action`	cancel
`orders`	Virgülle ayrılmış numaralar

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=23501,23502

Yanıt

[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Incorrect order ID" } }
]

Bakiye

Alan	Değer
`key`	Anahtarınız
`action`	balance

İstek

curl -X POST https://telegos.app/api/v2 \
  -d key=YOUR_KEY \
  -d action=balance

Yanıt

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

Sipariş durumları

Durum	Anlamı
`Pending`	Sipariş alındı, sağlayıcıya gönderilmeyi bekliyor
`In progress`	Teslim sürüyor
`Processing`	Sipariş sağlayıcı tarafında işleniyor
`Completed`	Hacim tamamen teslim edildi
`Partial`	Hacmin bir kısmı teslim edildi, kalanı bakiyeye döndü
`Canceled`	Sipariş iptal edildi, tutar geri verildi

Hatalar

Hata da aynı 200 koduyla gelir ve yalnızca error alanının varlığıyla ayrılır: yanıt durumuna değil, gövdeye bakın. Toplu işlemlerde hata kendi öğesinin içinde durur ve diğerlerini iptal etmez.

Yanıt

{
  "error": "Incorrect request"
}