BAYİ API v2

Paneli kendi sistemine bağla.

Servisleri kendi panelinden, sitenden veya botundan sat. Tek anahtar, tek endpoint; siparişi açtığın anda tutar bakiyenden düşer ve sipariş işleme alınır.

Tek endpoint, dört aksiyon: services, balance, add, status Sipariş tutarı anında cüzdan bakiyenden düşer form-urlencoded, sorgu dizesi veya JSON gövde ile çalışır

API anahtarını al Dokümantasyon

Kimlik doğrulama her istekte gönderilen key parametresiyle yapılır.

curl -X POST https://api.takiplus.com/api/v2 \
  -d key=tkp_live_… \
  -d action=add \
  -d service=3a1c… \
  -d link=https://instagram.com/markan \
  -d quantity=1000

$ch = curl_init('https://api.takiplus.com/api/v2');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
  'key'      => 'tkp_live_…',
  'action'   => 'add',
  'service'  => '3a1c…',
  'link'     => 'https://instagram.com/markan',
  'quantity' => 1000,
]));
$order = json_decode(curl_exec($ch), true);

const res = await fetch('https://api.takiplus.com/api/v2', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    key: 'tkp_live_…',
    action: 'add',
    service: '3a1c…',
    link: 'https://instagram.com/markan',
    quantity: 1000,
  }),
});
const order = await res.json();

YANIT · 200 OK

{ "order": "9f2b…" }

API canlı https://api.takiplus.com/api/v2

ENDPOINT'LER

Tek endpoint, dört aksiyon

Tüm istekler aynı adrese POST olarak gider; ne yapılacağını action parametresi belirler.

POST https://api.takiplus.com/api/v2

POST action=services Sipariş verilebilir servislerin listesi, min-max adet aralığı ve KDV dahil fiyatlar → service, rate, min, max POST action=balance Anlık cüzdan bakiyesi ve para birimi → balance, currency POST action=add Yeni sipariş oluşturur, tutarı bakiyeden düşer ve sipariş kimliği döner → order POST action=status Sipariş durumu, kalan miktar ve başlangıç sayacı → status, remains, start_count

Bu dört aksiyonun dışındaki her action değeri hata döner. API'de refill veya cancel çağrısı yoktur; telafi süreçleri sistem tarafında otomatik yürütülür.

Örnek istek ve yanıtlar

Her aksiyon için gerekli parametreler, örnek istek ve API'nin gerçekte döndürdüğü yanıt biçimi.

Servis listesi

action=services

Sipariş verilebilir servisleri döner. rate alanı 1000 adet için geçerli fiyattır ve KDV dahildir.

key	API anahtarınız
action	services

İSTEK

curl -X POST https://api.takiplus.com/api/v2 \
  -d key=API_ANAHTARINIZ \
  -d action=services

YANIT

[
  {
    "service": "3a1c…",
    "name": "Instagram Takipçi",
    "type": "Default",
    "category": "Instagram",
    "rate": "12.5",
    "min": "100",
    "max": "50000",
    "currency": "TRY"
  }
]

Bakiye sorgula

action=balance

Cüzdan bakiyenizi döner. Sipariş açmadan önce yeterli bakiye olduğunu bu çağrıyla doğrulayabilirsiniz.

key	API anahtarınız
action	balance

İSTEK

curl -X POST https://api.takiplus.com/api/v2 \
  -d key=API_ANAHTARINIZ \
  -d action=balance

YANIT

{ "balance": "125.40", "currency": "TRY" }

Sipariş oluştur

action=add

Yeni sipariş açar. Tutar bakiyenizden düşülür ve sipariş otomatik olarak işleme alınır.

key	API anahtarınız
action	add
service	Servis kimliği (services listesinden)
link	Hedef bağlantı (profil veya gönderi adresi)
quantity	Adet (servisin min-max aralığında)

İSTEK

curl -X POST https://api.takiplus.com/api/v2 \
  -d key=API_ANAHTARINIZ \
  -d action=add \
  -d service=3a1c… \
  -d link=https://instagram.com/kullanici \
  -d quantity=1000

YANIT

{ "order": "9f2b…" }

Sipariş durumu

action=status

Tek sipariş için order, çoklu sorgu için virgülle ayrılmış orders parametresini kullanın.

key	API anahtarınız
action	status
order	Sipariş kimliği (veya orders=id1,id2)

İSTEK

curl -X POST https://api.takiplus.com/api/v2 \
  -d key=API_ANAHTARINIZ \
  -d action=status \
  -d order=9f2b…

YANIT

{
  "charge": "12.5",
  "start_count": "3400",
  "status": "In progress",
  "remains": "250",
  "currency": "TRY"
}

Durum değerleri

status yanıtındaki status alanı şu değerlerden birini alır:

PendingIn progressCompletedPartialCanceled

Hata biçimi

Hatalı isteklerde yanıt error alanı içerir; HTTP durum kodu 400, 401 veya 404 olur.

{ "error": "Yetersiz bakiye." }

ÇALIŞMA MODELİ

Anahtar, bakiye, sipariş.

Entegrasyonun tamamı üç parçadan oluşur. Ayrı sözleşme, ayrı ödeme entegrasyonu veya her sipariş için manuel onay adımı yok; akış baştan sona senin sisteminden yürür.

Kimlik doğrulama her istekte gönderilen key parametresiyle yapılır. Ayrı oturum açma, token yenileme veya imza hesaplama adımı yoktur.

Sipariş tutarı, sipariş açıldığı anda cüzdan bakiyenden düşülür. Bakiye yetmezse sipariş işleme alınmaz ve yanıtta error alanı döner.

rate alanı 1000 adet için geçerli fiyattır ve KDV dahildir. add çağrısında ücret birim fiyat ile adedin çarpımıdır; üzerine ayrıca KDV eklenmez.

Sipariş açıldıktan sonra otomatik olarak işleme alınır. İlerlemeyi status aksiyonuyla takip edersin; telafi süreçleri sistem tarafında yürür.

BAŞLANGIÇ

Nasıl başlanır?

Başvuru formu veya bekleme süreci yok. Anahtarını üret, bakiyeni yükle, ilk siparişini aç.

01
Panelden anahtar üret

Panelde API sekmesini aç, istersen anahtara bir ad ver ve yeni anahtar oluştur. Anahtar tkp_live_ ön ekiyle başlar ve yalnızca bir kez gösterilir, hemen güvenli bir yere kopyala.
02
Bakiye yükle

API siparişleri cüzdan bakiyesinden düşer. Panelden bakiye yükle, ardından action=balance çağrısıyla bakiyenin göründüğünü doğrula.
03
Servis listesini çek

action=services ile sipariş verilebilir servisleri al. Her kayıtta sipariş için gereken service kimliği, min-max adet aralığı ve 1000 adet fiyatı bulunur.
04
Sipariş aç ve takip et

action=add ile siparişi oluştur, yanıtta dönen order kimliğini kendi tarafında sakla ve action=status ile ilerlemeyi kendi panelinde göster.

Sık sorulan sorular

API anahtarını nasıl alırım?

Takiplus hesabına giriş yap, panelde API sekmesini aç ve yeni anahtar oluştur. Anahtar tkp_live_ ön ekiyle başlar ve yalnızca oluşturma anında bir kez gösterilir; sistemde açık hâliyle saklanmaz, yalnızca özeti tutulur. Aynı anda en fazla 10 aktif anahtarın olabilir, dilediğin anahtarı panelden iptal edebilirsin.

Hangi aksiyonlar destekleniyor?

Dört aksiyon vardır: services (sipariş verilebilir servis listesi), balance (cüzdan bakiyesi), add (yeni sipariş) ve status (sipariş durumu). Bunların dışında bir action gönderilirse yanıt hata döner. Telafi ve iptal süreçleri sistem tarafında otomatik yürütüldüğü için API üzerinden ayrı bir refill veya cancel çağrısı yapılmaz.

Siparişin ücreti nereden düşülür?

Sipariş tutarı, siparişin açıldığı anda hesabının cüzdan bakiyesinden düşülür. Kredi kartı veya ayrı bir ödeme akışı devreye girmez. Bakiye yetersizse sipariş işleme alınmaz ve yanıt gövdesinde error alanı döner, bu yüzden entegrasyonunda bakiye kontrolünü de kurgulaman iyi olur.

Fiyatlara KDV dahil mi?

Evet. services yanıtındaki rate alanı 1000 adet için geçerli, KDV dahil fiyattır. add çağrısında bakiyenden düşülen tutar birim fiyat ile adedin çarpımıdır ve bu tutarın üzerine ayrıca KDV eklenmez. Yani API yanıtında gördüğün fiyat, bakiyenden düşecek olan nihai fiyattır.

İstekleri nasıl göndermeliyim?

Tek endpoint kullanılır ve istek POST olarak gönderilir. Parametreleri form-urlencoded gövdede, sorgu dizesinde veya JSON gövdede gönderebilirsin; üçü de kabul edilir. Her istekte key parametresi bulunmak zorundadır ve yanıtlar JSON biçimindedir. Alan adları SMM Panel API v2 ile uyumludur.

Sipariş durumunu nasıl sorgularım?

action=status çağrısında tek sipariş için order parametresini kullan. Birden çok siparişi tek istekte sorgulamak için virgülle ayrılmış orders parametresini gönderebilirsin. Yanıtta charge, start_count, status, remains ve currency alanları döner. Durum değerleri Pending, In progress, Completed, Partial ve Canceled olabilir.

Hata durumunda ne dönüyor?

Hatalı isteklerde yanıt gövdesi error alanı içerir ve HTTP durum kodu 400, 401 veya 404 olur. Anahtar gönderilmediğinde veya geçersiz olduğunda 401, eksik ya da aralık dışı parametrede 400, bulunamayan servis veya siparişte 404 alırsın. Entegrasyonunda önce error alanının varlığını kontrol etmen en sağlıklı yaklaşımdır.

Servis kimliğini nereden alıyorum?

action=services yanıtındaki service alanı, add çağrısında göndereceğin servis kimliğidir. Aynı kayıtta servisin adı, kategorisi, 1000 adet fiyatı ve min ile max adet sınırları da bulunur. Gönderdiğin quantity değeri bu aralığın dışındaysa sipariş açılmaz ve hata döner, bu yüzden listeyi kendi tarafında güncel tutmak gerekir.

Her servis API üzerinden sipariş edilebilir mi?

Hayır. API yalnızca aktif olan ve tedarik eşlemesi bulunan servisleri listeler ve kabul eder; listede olmayan bir servis kimliği gönderirsen sipariş açılmaz. Birden çok hizmeti tek pakette birleştiren kombin paketler de API üzerinden sipariş edilemez, bunlar panel üzerinden verilir.

Anahtarım sızarsa ne yapmalıyım?

Panelden o anahtarı hemen iptal et ve yeni bir anahtar oluştur. İptal edilen anahtarla yapılan istekler anında geçersiz sayılır ve yetkisiz yanıtı alır. Anahtar açık hâliyle saklanmadığı için kaybedersen tekrar görüntülenemez; bu durumda da yenisini oluşturman gerekir. Anahtarı istemci tarafında değil, yalnızca kendi sunucunda tut.

Mevcut SMM panel yazılımıma bağlanır mı?

Endpoint ve alan adları SMM Panel API v2 standardıyla uyumludur, bu yüzden bu standardı destekleyen panel yazılımlarında sağlayıcı olarak tanımlanabilir. Kurulumda API adresi olarak api.takiplus.com üzerindeki v2 adresini, anahtar olarak da panelden ürettiğin anahtarı girmen yeterlidir.

Anahtar kullanımını takip edebiliyor muyum?

Evet. Panelde her anahtar için oluşturma tarihi, son kullanım zamanı ve toplam istek sayısı görünür. Böylece hangi entegrasyonun çalıştığını, hangi anahtarın artık kullanılmadığını görebilir ve kullanılmayan anahtarları güvenlik için iptal edebilirsin.

// HEMEN BAŞLA

Entegrasyona bugün başla.

Panelden anahtarını üret, bakiyeni yükle ve servisleri kendi sisteminden satmaya başla. Entegrasyon için tek ihtiyacın olan şey bir endpoint ve bir anahtar.

API anahtarını al Ücretsiz hesap aç

Siparişler cüzdan bakiyesinden düşer, fiyatlar KDV dahildir

Diğer panel özellikleri

Paneli kendi sistemine bağla.

Tek endpoint, dört aksiyon

Örnek istek ve yanıtlar

Servis listesi

Bakiye sorgula

Sipariş oluştur

Sipariş durumu

Durum değerleri

Hata biçimi

Anahtar, bakiye, sipariş.

Nasıl başlanır?

Panelden anahtar üret

Bakiye yükle

Servis listesini çek

Sipariş aç ve takip et

Sık sorulan sorular

Entegrasyona bugün başla.