API: домены

Базовый URL: https://scamprojecttest.xyz/api/v1. Общие правила (авторизация, лимиты, ошибки, идемпотентность) собраны в обзоре.

Аккаунт

Метод	Путь	Scope	Описание
GET	`/users/me`	`domains:read`	Профиль ключа и пользователя
GET	`/users/{user_id}/balance`	`domains:read`	Баланс
GET	`/transactions`	`domains:read`	Транзакции (пагинация, `?user_id=`)
GET	`/referrals`	`domains:read`	Реферальная статистика

curl https://scamprojecttest.xyz/api/v1/users/me -H "Authorization: Bearer $KEY"

{
  "principal": { "key_id": 3, "name": "reseller acme", "role": "reseller", "scopes": ["domains:read","domains:buy"], "user_id": 42 },
  "user": { "id": 42, "telegram_id": 666971555, "balance_usd": "12.50", "is_banned": false }
}

Домены

Список доменов

GET /domains · scope domains:read · пагинация · ?user_id= (operator)

Карточка домена

GET /domains/{domain_id} · scope domains:read. Reseller видит только свои; чужой id → 404.

Проверка доступности

GET /domains/check?names=a.com,b.net · scope domains:read · до 50 имён

{ "results": [ { "domain": "a.com", "available": false, "price_usd": "17.00", "error": null } ] }

Цена TLD

GET /domains/price?tld=com · scope domains:read

{ "tld": "com", "price_usd": "17.00", "supported": true }

Массовая проверка

POST /domains/check:bulk · scope domains:read · тело { "names": ["a.com","b.net"] } → bulk-конверт.

Покупка (деньги)

Денежные эндпоинты требуют API_MONEY_ENABLED, scope domains:buy, заголовок Idempotency-Key и (если включена) подпись X-Signature.

Массовая регистрация

POST /domains/register:bulk · scope domains:buy · деньги · async → 202

curl -X POST "https://scamprojecttest.xyz/api/v1/domains/register:bulk" \
  -H "Authorization: Bearer $KEY" \
  -H "Idempotency-Key: reg-2026-06-09-001" \
  -H "Content-Type: application/json" \
  -d '{"names":["example-store-1.com","example-store-2.net"]}'

{ "batch_id": "checkout:1234", "accepted": 2, "status": "pending" }

Operator обязан указать покупателя: ?user_id=42. Регистрация идёт фоном; статус смотри в GET /batches/checkout:1234. Невалидные строки дают 422 с разбором по позициям; ни одна из них не оплачивается. Премиум-имена (по цене реестра) недоступны и в регистрацию не уходят.

Статус заказов

POST /orders/status:bulk · scope domains:read · тело { "ids": [101,102] }.

Статус batch-задачи

GET /batches/{batch_id} · scope domains:read.

Пополнение баланса (деньги)

Создать счёт

POST /deposits · scope deposits:write · деньги → 201

Поле	Тип	Описание
`amount_usd`	строка/число > 0	Сумма к зачислению (1–1000)
`provider`	строка	`cryptobot` · `xrocket` · `lava` · `p2328` · `lolzteam`
`asset`	строка	(необяз.) монета для CryptoBot
`user_id`	число	Обязателен для operator-ключа

{ "provider":"cryptobot","external_id":"inv_123","pay_url":"https://...","amount_usd":"5","pay_usd":"5.15" }

Баланс пополняется после оплаты, по подписанному вебхуку провайдера, а не этим запросом.

Статус счёта

GET /deposits/{provider}/{external_id} · scope domains:read.

Операторские эндпоинты

Только operator-ключ (scope admin:*). Денежные требуют Idempotency-Key.

Метод	Путь	Описание
POST	`/admin/users/{user_id}/balance`	Корректировка баланса `{delta_usd, reason}` (деньги)
POST	`/admin/users/{user_id}/ban`	Бан/разбан `{banned, reason}`
POST	`/admin/deposits/{transaction_id}/mark-completed`	Ручное завершение депозита (деньги)
POST	`/admin/deposits/{transaction_id}/mark-failed`	Пометить депозит неуспешным

​Аккаунт

​Домены

​Список доменов

​Карточка домена

​Проверка доступности

​Цена TLD

​Массовая проверка

​Покупка (деньги)

​Массовая регистрация

​Статус заказов

​Статус batch-задачи

​Пополнение баланса (деньги)

​Создать счёт

​Статус счёта

​Операторские эндпоинты

Аккаунт

Домены

Список доменов

Карточка домена

Проверка доступности

Цена TLD

Массовая проверка

Покупка (деньги)

Массовая регистрация

Статус заказов

Статус batch-задачи

Пополнение баланса (деньги)

Создать счёт

Статус счёта

Операторские эндпоинты