API WL RUS Domains

1. Быстрый старт и доступ

Доступ к API открывается автоматически после того, как суммарные пополнения баланса (за всё время, только оплаченные счета) достигнут 10 $. Ключ выпускается самостоятельно в боте:

1. Откройте бота и перейдите в Профиль → 🔌 API.
2. Нажмите «Выпустить ключ». Ключ показывается один раз — сохраните его.
3. Повторный выпуск создаёт новый ключ, а прежний автоматически отзывается.

2. Авторизация

Ключ передаётся одним из двух заголовков:

Authorization: Bearer <ВАШ_КЛЮЧ>
X-Api-Key: <ВАШ_КЛЮЧ>

Без ключа возвращается 401 unauthorized. Если ключ действителен, но суммарных пополнений меньше 10 $ — 403 access_required.

3. Примеры

curl

curl -s https://api.wlrus.cfd/v1/me \
  -H "Authorization: Bearer $WLRUS_API_KEY"

# проверка свободен ли домен и цена
curl -s "https://api.wlrus.cfd/v1/check?domain=example.com&years=1" \
  -H "Authorization: Bearer $WLRUS_API_KEY"

JavaScript (fetch)

const API = "https://api.wlrus.cfd";
const KEY = process.env.WLRUS_API_KEY;

const r = await fetch(`${API}/v1/domains`, {
  headers: { Authorization: `Bearer ${KEY}` },
});
const data = await r.json();
console.log(data.domains);

Python (requests)

import requests

API = "https://api.wlrus.cfd"
KEY = "ваш_ключ"
s = requests.Session()
s.headers["Authorization"] = f"Bearer {KEY}"

print(s.get(f"{API}/v1/me").json())
print(s.get(f"{API}/v1/check", params={"domain": "example.com", "years": 1}).json())

4. Методы

{ "ok": true }

{
  "id": 123456789,
  "username": "user",
  "full_name": "Иван И.",
  "balance_usd": 25.40,
  "created_at": "2026-01-04 12:00:00",
  "topup_total_usd": 62.00,
  "api_access": true,
  "discount_percent": 10
}

{
  "domains": [
    {
      "id": 12, "domain": "example.com", "tld": "com", "status": "active",
      "years": 1, "registered_at": "2026-03-11 09:20:00", "expiry": "2027-03-11",
      "auto_renew": false, "nameservers": ["crystal.ns.cloudflare.com"],
      "owed": 0.0
    }
  ]
}

{ "records": [ { "id": "…", "type": "A", "host": "@", "value": "1.2.3.4",
                 "ttl": 3600, "proxied": false } ] }

{
  "type": "A",        // обязательно
  "host": "@",        // поддомен, по умолчанию "@"
  "value": "1.2.3.4", // обязательно
  "ttl": 3600,        // необязательно
  "proxied": false,   // оранжевое облако Cloudflare
  "priority": 10      // для MX/SRV
}

Ответ: 201 и { "record": { … } }.

{ "ok": true }

{ "domain": "example.com", "available": true, "years": 1,
  "price_total_usd": 14.03, "premium": false }

Если домен занят: { "domain": "…", "available": false }.

{
  "domain": "example.com",
  "years": 1,
  "use_cloudflare": false   // true — сразу подключить домен к Cloudflare
}

Ответы:

{ "years": 1 }
// → { "status": "renewed", "domain": "example.com", "years": 1,
//     "charged_usd": 12.51, "premium": false }

{ "invoices": [ { "created_at": "2026-04-02 10:11:12", "method": "lava",
                  "amount_usd": 20.0, "status": "paid", "paid_at": "2026-04-02 10:12:03" } ] }

5. Цены, скидки и лимиты

• Доступ к API: суммарные оплаченные пополнения ≥ 10 $.
• Скидка 10 % на первый год регистрации — навсегда, после суммарных пополнений ≥ 50 $.
• Скидка применяется к регистрации (первый год) и учитывается в /v1/check, /v1/domains/register; на продление она не действует.
• Текущее значение скидки — в поле discount_percent метода /v1/me.
• Rate limit: 60 запросов в минуту на ключ; при превышении — 429 rate_limited.
• Одновременно может выполняться только одна регистрация/продление на аккаунт — повторный запрос вернёт 429 busy.

6. Ошибки

Все ошибки имеют единый формат:

{ "error": { "code": "insufficient_funds", "message": "Недостаточно средств: нужно 14.03, на балансе 5.0" } }