API для разработчиков
Снимайте аккаунты программно — те же аккаунты, цены и баланс, что на сайте
Ваш API-ключ
до 150 запросов в минуту, оплата с балансаКак это работает
Каждый запрос авторизуется ключом в заголовке X-API-Key.
Деньги списываются с баланса владельца ключа, цена считается по тем же тарифам, что в каталоге.
Суммы везде в рублях числом с двумя знаками: 0.91 —
это 91 копейка, 150.70 — 150 ₽ 70 коп. Внутри баланса хранятся копейки,
поэтому списание точное, без округления до рубля.
(сутки по суточному тарифу, остаток — по часовому).
- GET /catalog — узнать product_id, цену и свободен ли аккаунт.
- POST /rentals — арендовать на N часов, в ответ приходят логин и пароль.
- POST /rentals/{id}/guard — запросить код Steam Guard, если Steam его попросит.
- POST /rentals/{id}/extend — продлить; POST /rentals/{id}/close — освободить досрочно.
Пример: взять аккаунт на 3 часа
curl -X POST "http://82-114-226-113.nip.io/api/v1/rentals" \
-H "X-API-Key: sr_live_ВАШ_КЛЮЧ" \
-H "Idempotency-Key: 397c6cc4-8ad4-561f-80e2-e8edbd5664aa" \
-H "Content-Type: application/json" \
-d '{"product_id": 1, "hours": 3, "buyer_ref": "customer_42"}'
Ответ 201:
{
"issue_id": 12,
"product_id": 1,
"product_name": "Assetto Corsa + все DLC",
"buyer_ref": "customer_42",
"hours": 3,
"price": 7.32,
"currency": "RUB",
"status": "active",
"started_at": "2026-11-18T16:20:11+03:00",
"ends_at": "2026-11-18T19:20:11+03:00",
"seconds_left": 10789,
"account": {"login": "assetto_acc_01", "password": "Ak7$treet22", "region": "RU"},
"balance": 1263.45,
"replayed": false
}
Идемпотентность
Ключ операции — UUID, сохраните его до запроса.
Повтор с тем же ключом и параметрами вернёт тот же ответ и "replayed": true — без второго списания.
Тот же ключ с другими параметрами → 409 attempt_changed.
Проверить, прошла ли операция после обрыва: GET /attempts/{key}.
buyer_ref — клиенты партнёра
Если вы продаёте дальше, передавайте стабильный ID своего клиента: buyer_ref=customer_42. У каждого клиента своя история и фильтры, баланс и аккаунты — общие.
1–128 символов: A–Z a–z 0–9 . _ : -. Не меняйте его от заказа к заказу — это ломает историю.
Steam Guard
Коды только автоматические. У аккаунта загружен maFile → POST /rentals/{id}/guard сразу отдаёт код: 200, "mode": "auto", expires_in ≈ 30 сек. Ждать и просить оператора не нужно.
Если у аккаунта нет maFile — 409 guard_unavailable: код выдать нечем, аккаунт нужно перезалить с maFile.
Прочие ответы: 409 guard_code_expired (код устарел — запросите новый). Текущее состояние — GET /rentals/{id}/guard-rules: поля mode (auto / none), available, reason.
Эндпоинты
база: 82-114-226-113.nip.io/api/v1| Метод | Путь | Что делает |
|---|---|---|
| GET | /ping | Проверка ключа и связи |
| GET | /me | Баланс, лимиты, активные аренды |
| GET | /catalog | Каталог: цена за час/сутки, свободен ли аккаунт. Параметры: search, available, limit, before |
| GET | /catalog/{product_id} | Один аккаунт + примеры цены на 1/3/24/72 ч |
| POST | /rentals | Взять аккаунт: product_id, hours, buyer_ref + Idempotency-Key |
| GET | /rentals | Мои аренды: status, buyer_ref, product_id, limit, before |
| GET | /rentals/{issue_id} | Одна аренда: срок, остаток секунд, данные входа |
| POST | /rentals/{issue_id}/extend | Продлить на hours (доплата с баланса) |
| POST | /rentals/{issue_id}/close | Закрыть досрочно, аккаунт освобождается |
| GET | /rentals/{issue_id}/guard-rules | Лимиты кодов: can_request, retry_after, remaining |
| POST | /rentals/{issue_id}/guard | Запросить код Steam Guard + Idempotency-Key |
| GET | /guard/{request_id} | Опрос статуса выданного кода |
| GET | /attempts/{key} | Была ли операция с таким Idempotency-Key |
| GET | /buyers | Список buyer_ref с числом аренд |
Коды ошибок
| HTTP | code | Когда |
|---|---|---|
| 401 | unauthorized | Нет, неверный или отозванный ключ |
| 403 | forbidden | Аккаунт заблокирован |
| 404 | product_not_found | Нет такого product_id |
| 404 | not_found | Аренда не ваша / не существует |
| 409 | insufficient_balance | Мало денег: required, balance, missing |
| 409 | no_accounts | Аккаунт занят: busy_until |
| 409 | account_unavailable | Аренда уже завершена |
| 409 | attempt_changed | Ключ уже был с другими параметрами |
| 409 | idempotency_key_conflict | Заголовок и JSON различаются |
| 409 | buyer_ref_conflict | buyer_ref в query и JSON различаются |
| 409 | code_cooldown | Рано просить код: retry_after |
| 409 | code_limit | Лимит кодов за сутки исчерпан |
| 409 | guard_code_expired | Код истёк — новый запрос с новым ключом |
| 422 | idempotency_key_required | Нет Idempotency-Key |
| 422 | invalid_hours | hours вне 1–720 |
| 422 | invalid_buyer_ref | Недопустимые символы в buyer_ref |
| 429 | rate_limited | Больше 150 запросов в минуту |
Ещё примеры
Каталог — только свободные:
curl -H "X-API-Key: sr_live_..." \ "82-114-226-113.nip.io/api/v1/catalog?available=1&limit=20"
Код Steam Guard и опрос:
curl -X POST -H "X-API-Key: sr_live_..." \ -H "Idempotency-Key: $(uuidgen)" \ "82-114-226-113.nip.io/api/v1/rentals/12/guard" curl -H "X-API-Key: sr_live_..." \ "82-114-226-113.nip.io/api/v1/guard/5"
Проверка после таймаута:
curl -H "X-API-Key: sr_live_..." \ "82-114-226-113.nip.io/api/v1/attempts/397c6cc4-..."
Python:
import requests, uuid
H = {"X-API-Key": "sr_live_...", "Idempotency-Key": str(uuid.uuid4())}
r = requests.post("http://82-114-226-113.nip.io/api/v1/rentals",
headers=H, json={"product_id": 1, "hours": 3},
timeout=30)
print(r.status_code, r.json())