API документация

Список услугaction = services

Параметр Объяснение

key Ваш API ключ

action services

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

[
  {
    "service": 1,
    "name": "Followers",
    "type": "Default",
    "category": "First Category",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  },
  {
    "service": 2,
    "name": "Comments",
    "type": "Custom Comments",
    "category": "Second Category",
    "rate": "8",
    "min": "10",
    "max": "1500",
    "refill": false,
    "cancel": false
  }
]

Новый заказaction = add

Тип услуги

Параметр Объяснение

key Ваш API ключ

action add

service ID услуги

link Ссылка на страницу

quantity Необходимое количество

runs (опционально) Запусков

interval (опционально) Интервал в минутах

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

{
  "order": 23501
}

Повтор без двойного заказа (Idempotency-Key)action = add

К action=add можно приложить ключ — заголовок Idempotency-Key или поле idempotency_key: строку до 128 латинских букв, цифр и знаков без пробелов, новую для каждого заказа. Если ответ не дошёл и вы повторите запрос с тем же ключом и теми же параметрами в течение 24 часов, вернётся тот же номер заказа, второго заказа и второго списания не будет.

Параметр Объяснение

Idempotency-Key / idempotency_key Ключ этого заказа (заголовок или поле), до 128 символов

HTTP 200 повтор с тем же ключом и параметрами — тот же ответ (тот же номер заказа) и заголовок Idempotent-Replayed: true

status 122 ключ уже использован для запроса с другими параметрами — заказ не создан

HTTP 429, status 123 первый запрос с этим ключом ещё выполняется — повторите через Retry-After секунд

HTTP 500, status 124 итог первого запроса неизвестен — проверьте заказы, прежде чем отправлять новый

HTTP 500, status 125 деньги по первому запросу могли быть списаны без заказа — ручная сверка через поддержку; новый заказ — с новым ключом

Лимит частоты запросов

На один ключ — до 600 запросов в минуту, из них до 30 запросов action=services. Сверх лимита ответ — HTTP 429, заголовок Retry-After (через сколько секунд повторить) и JSON с status 120. После 30 неверных ключей за минуту с одного IP следующие неверные ключи с него тоже получают 429; запросы с верным ключом этот счёт не затрагивает.

Ответ сверх лимита — HTTP 429, Retry-After

{
  "error": "…",
  "status": "120"
}

Статус заказаaction = status

Параметр Объяснение

key Ваш API ключ

action status

order ID заказа

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

{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "USD"
}

Статус нескольких заказовaction = status

Параметр Объяснение

key Ваш API ключ

action status

orders ID заказов (разделенные запятой, до 100 идентификаторов)

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

{
  "1": {
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
  },
  "10": {
    "error": "Incorrect order ID"
  },
  "100": {
    "charge": "1.44219",
    "start_count": "234",
    "status": "In progress",
    "remains": "10",
    "currency": "USD"
  }
}

Восстановление заказаaction = refill

Для выполненных заказов услуг с восстановлением (refill: true в списке услуг) в пределах срока гарантии, не чаще раза в сутки. В ответе — ID восстановления.

Параметр Объяснение

key Ваш API ключ

action refill

order ID заказа

orders Вместо order: до 100 ID заказов через запятую или JSON-массив; общий бюджет внешних вызовов — 30 секунд. В ответе результат каждого ID.

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

{
  "refill": 1
}

Статус восстановленияaction = refill_status

Возможные статусы: Pending, Accepted, In progress, Completed, Rejected.

Параметр Объяснение

key Ваш API ключ

action refill_status

refill ID восстановления (из ответа refill)

refills Вместо refill: до 100 ID заявок через запятую или JSON-массив; несуществующий или чужой ID получает not_found отдельно.

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

{
  "status": "Completed"
}

Отмена заказаaction = cancel

Для услуг с отменой (cancel: true в списке услуг) и заказов в статусе Pending, In progress или Processing. Заявку рассматривает администрация, итог виден в статусе заказа: Canceled — деньги вернулись на баланс. Повторный запрос по тому же заказу новую заявку не создаёт и возвращает тот же ID.

Параметр Объяснение

key Ваш API ключ

action cancel

order ID заказа

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

{
  "cancel": 1
}

Отмена нескольких заказовaction = cancel

Ответ — по одной записи на каждый заказ: ID заявки на отмену или ошибка.

Параметр Объяснение

key Ваш API ключ

action cancel

orders ID заказов (разделенные запятой, до 100 идентификаторов)

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

[
  {
    "order": 9,
    "cancel": {"error": "Incorrect order ID"}
  },
  {
    "order": 2,
    "cancel": 1
  }
]

Баланс пользователяaction = balance

Параметр Объяснение

key Ваш API ключ

action balance

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

{
  "balance": "100.84292",
  "currency": "USD"
}