Daha net bir bakış. Daha düzenli bir iş akışı.

Giris

xspecial REST API, panelin butun operasyonlarini (gorev turleri, warmup, engage, growth, autocomplete) HTTP ile tetiklemenize olanak tanir. Hem modern RESTful endpoint'ler hem de klasik SMM panel formati (action=...) ayni anda desteklenir.

Base URL: http://SUNUCU:PORT/api/v1

Hizli sinama (auth gerekmez):

GET /api/v1/status  →  {"status":"active","accounts":5000,"available":4300,...}

Kimlik Dogrulama

Asagidaki 3 yoldan biri yeterlidir:

// 1) Header (onerilen)
X-Api-Key: YOUR_API_KEY

// 2) Query
?api_key=YOUR_API_KEY

// 3) Body
{ "api_key": "YOUR_API_KEY", ... }

Servis Kataloğu (SMM API)

Güncel servis ID'leri (/api/v2/services ile aynı):

Not: RT+Like kombosu ve baska pano gorevleri harici API listesinde yok; profil tiklama, link tiklama ve arama onerisi SMM listesinde yer almaz.

/order — Evrensel Siparis

SMM panel uyumlu, tek endpoint ile tum servisler.

{
  "service_id": 1,
  "link": "https://x.com/user/status/123",
  "quantity": 1000
}

Tipe Ozel Ekstra Alanlar

Yanit

{
  "order_id": 12345,
  "status": "processing",
  "quantity": 1000,
  "accounts": 842,
  "queue_position": 0
}

/task — Gelismis Gorev

Panel'in ic gorev sistemine direkt erisim. 19 task type destekler.

{
  "name": "Kampanya #42",
  "type": "comment",
  "config": { "tweet_id": "123", "comment_mode": "random_tr" },
  "account_count": 100,
  "account_ids": [5, 12, 33],
  "start_now": true
}

Desteklenen type: like, unlike, retweet, unretweet, rt_like, follow, unfollow, bookmark, comment, view, poll_vote, join_space, join_broadcast, list_follow, quote_tweet, autocomplete_signal, profile_click, link_click — harici SMM siparis API'sinde listelenenler icin yukaridaki tabloya bakin.

Kisa Yol Endpoint'leri

Sik kullanilanlar icin tek-amaca ozel endpoint'ler:

POST /api/v1/like        { link, account_count }
POST /api/v1/retweet     { link, account_count }
POST /api/v1/bookmark    { link, account_count }
POST /api/v1/follow      { link OR username }
POST /api/v1/unfollow    { link OR username }
POST /api/v1/comment     { link, comment_text / comment_mode }
POST /api/v1/quote       { link, quote_text, topics[], hashtags[] }
POST /api/v1/poll-vote   { link, choice, card_uri, card_name }
POST /api/v1/space       { link, listen_duration }
POST /api/v1/broadcast   { link }
POST /api/v1/list-follow { link }
POST /api/v1/view        { link, quantity, view_mode }

Warmup API

POST /api/v1/warmup/start  { account_ids[], filter, duration_hours }
POST /api/v1/warmup/stop   { account_ids[] }
GET  /api/v1/warmup/status

filter: "shadowban", "idle" veya bos (tum hesaplar)

Engage Jobs API

POST /api/v1/engage/create     (body)
POST /api/v1/engage/:id/start
POST /api/v1/engage/:id/stop
GET  /api/v1/engage/:id

Body icinde mode: "manual" veya "auto", target_users[], scan_interval, do_like, do_retweet.

Growth Plans API

POST /api/v1/growth/create     (body)
POST /api/v1/growth/:id/start
POST /api/v1/growth/:id/stop
GET  /api/v1/growth/:id

Modlar: home_timeline, link_target, keyword_search.

Siparis / Gorev Durumu

GET /api/v1/order/:id         // tek
GET /api/v1/orders?ids=1,2,3  // coklu
GET /api/v1/order/:id/logs    // log satirlari
GET /api/v1/tasks?limit=25    // son gorevler

Ornek Yanit

{
  "order_id": 12345,
  "status": "In progress",
  "quantity": 1000,
  "progress": 640,
  "completed": 612,
  "failed": 28,
  "remains": 360
}

Siparis Kontrolu

POST /api/v1/order/:id/cancel
POST /api/v1/order/:id/pause
POST /api/v1/order/:id/resume

Hesap Raporlari

GET /api/v1/accounts/summary
GET /api/v1/accounts/list?limit=50&offset=0

Summary Yaniti

{
  "total": 5000, "valid": 4820,
  "suspended": 120, "locked": 60,
  "available": 4350,
  "healthy": 3900, "risky": 620, "critical": 300
}

SMM Panel Uyumu (Legacy)

Klasik SMM formati icin tek endpoint, 4 action:

POST /api/v1
action=services&key=YOUR_KEY
action=add&service=1&link=...&quantity=1000&key=YOUR_KEY
action=status&order=12345&key=YOUR_KEY
action=balance&key=YOUR_KEY

Hata Kodlari

Kod Ornekleri

cURL

curl -X POST http://localhost:3000/api/v1/order \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_id":1,"link":"https://x.com/x/status/1","quantity":500}'

Python

import requests
API, KEY = "http://localhost:3000/api/v1", "YOUR_KEY"
H = {"X-Api-Key": KEY, "Content-Type":"application/json"}
r = requests.post(f"{API}/like", headers=H, json={
  "link": "https://x.com/x/status/1",
  "account_count": 200
})
print(r.json())

Node.js

const r = await fetch("http://localhost:3000/api/v1/follow", {
  method: "POST",
  headers: {"X-Api-Key":"YOUR_KEY","Content-Type":"application/json"},
  body: JSON.stringify({ username: "elonmusk", account_count: 100 })
});
console.log(await r.json());