Pro resellery a vývojáře

Dokumentace Panel API v2

Jediný endpoint kompatibilní se standardem API SMM panelů. Posílej form-encoded nebo JSON POST requesty, autorizuj se API klíčem svého child panelu a ovládej celý katalog programově.

POSThttps://koupitsledujici.cz/api/v2

Každý request nese dva povinné parametry: key (API klíč tvého child panelu) a action (jedna z akcí services, add, status, balance). Klíč najdeš ve svém účtu v sekci Child panel.

services

Vrátí kompletní seznam služeb, které můžeš přeprodávat, včetně aktuálních sazeb a limitů množství.

Pole odpovědi akce services
Pole	Význam
service	Číselné ID služby používané v akci add.
name	Čitelný název služby.
rate	Cena za 1 000 jednotek v Kč.
min	Minimální množství objednávky.
max	Maximální množství objednávky.
refill	Zda má služba záruku doplnění.

POST /api/v2 · action=services

curl -X POST https://koupitsledujici.cz/api/v2 \
  -d "key=TVUJ_API_KLIC" \
  -d "action=services"

Odpověď · 200 OK

[
  {
    "service": 1,
    "name": "Instagram sledující – Kvalitní",
    "rate": "149.00",
    "min": 100,
    "max": 50000,
    "refill": true
  },
  {
    "service": 2,
    "name": "TikTok zhlédnutí – Standard",
    "rate": "29.00",
    "min": 500,
    "max": 1000000,
    "refill": false
  }
]

add

Založí novou objednávku. Cena se strhne z tvého zůstatku a doručování se spustí automaticky.

Parametry akce add
Parametr	Význam
service	ID služby z akce services.
link	Veřejná URL profilu nebo příspěvku, kam se má doručovat.
quantity	Objednané množství v rámci limitů min/max dané služby.

POST /api/v2 · action=add

curl -X POST https://koupitsledujici.cz/api/v2 \
  -d "key=TVUJ_API_KLIC" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://www.instagram.com/tvujprofil/" \
  -d "quantity=1000"

Odpověď · 200 OK

{
  "order": "KS-8421-XQ"
}

Vrácené ID order pak předáváš akci status.

status

Vrátí živý stav objednávky — kolik už je doručeno, kolik zbývá a kolik stála.

Pole odpovědi akce status
Pole	Význam
charge	Částka účtovaná za objednávku.
start_count	Hodnota počítadla ve chvíli startu doručování.
status	Stav objednávky — viz slovník níže.
remains	Množství, které zbývá doručit.
progress	Průběh doručení od 0 do 1.
currency	Měna účtované částky (CZK).

POST /api/v2 · action=status

curl -X POST https://koupitsledujici.cz/api/v2 \
  -d "key=TVUJ_API_KLIC" \
  -d "action=status" \
  -d "order=KS-8421-XQ"

Odpověď · 200 OK

{
  "charge": "149.00",
  "start_count": 1205,
  "status": "In progress",
  "remains": 430,
  "progress": 0.57,
  "currency": "CZK"
}

balance

Vrátí aktuální zůstatek kreditu, aby tvůj software přestal prodávat dřív, než dojde.

POST /api/v2 · action=balance

curl -X POST https://koupitsledujici.cz/api/v2 \
  -d "key=TVUJ_API_KLIC" \
  -d "action=balance"

Odpověď · 200 OK

{
  "balance": "1250.00",
  "currency": "CZK"
}

Slovník stavů

Pole status u objednávky nabývá vždy jedné z těchto hodnot:

Hodnoty stavu objednávky
Status	Význam
Pending	Objednávka byla přijata a čeká na spuštění.
In progress	Doručování právě probíhá.
Partial	Doručování se zastavilo před dokončením; nedoručená část se vrací na tvůj zůstatek.
Completed	Celé množství bylo doručeno.
Canceled	Objednávka byla zrušena a v plné výši vrácena na zůstatek.

Ještě nemáš API klíč?

Založ si child panel ve svém účtu — klíč dostaneš okamžitě.

Více o child panelu