Быстрый старт

1) Получи токен

Открой в боте: Профиль → API → скопируй API-токен.

2) Делай запросы на Base URL

https://proxy.killa.cc/api/v1

3) Передавай токен в заголовке

Authorization: Bearer YOUR_TOKEN

Пример 1 — проверить баланс

curl -s https://proxy.killa.cc/api/v1/balance \
  -H "Authorization: Bearer YOUR_TOKEN"

Пример ответа:

{
  "ok": true,
  "data": {
    "balance_rub": 1234.56,
    "api_spent_rub": 1235
  }
}

Пример 2 — посчитать стоимость (quote) перед покупкой Dedicated

curl -s "https://proxy.killa.cc/api/v1/dedicated/quote?country_code=RU&period=30&count=10&ipv=4" \
  -H "Authorization: Bearer YOUR_TOKEN"

Параметры:

• country_code — страна

• period — период (дни)

• count — количество

• ipv — версия IP

Пример 3 — купить Dedicated

curl -s https://proxy.killa.cc/api/v1/dedicated/buy \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country_code": "RU",
    "period": 30,
    "count": 10,
    "ipv": 4
  }'

Типовые сценарии (что делать дальше)

• Dedicated: quote → buy → (prolong / protocol)

• Premium: traffic/quote → traffic/buy → proxies/generate → (whitelist / password)

• VPN: vpn/quote → vpn/buy → vpn/info → vpn/renew

Формат ошибки (пример)

{
  "ok": false,
  "error": {
    "code": "invalid_token",
    "message": "Unauthorized",
    "details": null
  }
}

Подсказка:

• 401 — токен неверный/отсутствует

• 400 — неверные параметры запроса

• 5xx — внутренняя ошибка или ошибка upstream