API провайдера услуг

Интеграция в стиле Perfect Panel API v2. Все методы — один эндпоинт, авторизация по API-ключу.

Base URL: https://instantindex.duckdns.org/api/v2
Метод: POST (application/x-www-form-urlencoded) или GET с теми же параметрами
Формат ответа: JSON, UTF-8
Авторизация: параметр key — API-ключ провайдера

Методы

1. Список услуг — `action=services`

Параметр	Обязателен	Описание
`key`	да	API-ключ
`action`	да	`services`

POST /api/v2
key=***&action=services

→ 200 OK
[
  {"service":1,"name":"Ускорить индексацию","type":"Package","category":"Indexing","rate":"1.00","min":"1","max":"1","refill":false,"cancel":false}
]

2. Создать заказ — `action=add`

Параметр	Обязателен	Описание
`key`	да	API-ключ
`action`	да	`add`
`service`	да	ID услуги (1 — Ускорить индексацию)
`link`	да	URL, который нужно продвинуть

POST /api/v2
key=***&action=add&service=1&link=https://example.com/page

→ 200 OK
{"order":23501}

Заказ выполняется асинхронно; результат — через action=status.

3. Статус заказа — `action=status`

Параметр	Обязателен	Описание
`order`	да*	ID заказа
`orders`	да*	ID через запятую, до 100

POST /api/v2
key=***&action=status&order=23501

→ 200 OK
{"charge":"1.00","start_count":"0","status":"Completed","remains":"0","currency":"TOKEN"}

POST /api/v2
key=***&action=status&orders=23501,23502

→ 200 OK
{"23501":{"charge":"1.00","start_count":"0","status":"Completed","remains":"0","currency":"TOKEN"},
 "23502":{"error":"Incorrect order ID"}}

4. Баланс — `action=balance`

POST /api/v2
key=***&action=balance

→ 200 OK
{"balance":"100.00","currency":"TOKEN"}

Статусы заказа

Значение	Смысл
`In progress`	заказ выполняется
`Completed`	выполнен полностью
`Partial`	выполнен частично
`Canceled`	выполнить не удалось

Ошибки

HTTP 401 — неверный или отсутствующий ключ: {"error":"Incorrect API key"}.
В остальных случаях ответ 200 с полем error:

`error`	Причина
`Incorrect service ID`	неизвестный номер услуги
`Incorrect link`	некорректный URL
`Not enough funds`	недостаточно средств на балансе ключа
`Service temporarily unavailable`	нет доступных площадок
`Incorrect order ID`	заказ не найден
`Incorrect action`	неизвестное действие

Тестовый доступ

Тестовый API-ключ предоставляется владельцем сервиса. Ключ выдаётся с балансом; пополнение баланса ключа — по запросу.

Совместимость

Контракт совместим с Perfect Panel API v2 (методы services, add, status, balance). Для интеграции в качестве провайдера — заявка на интеграцию.