# w-b.pages.dev — открытый API бесплатных субдоменов

Сервис выдаёт бесплатные субдомены вида `name.lylymbi.dpdns.org`.
Без ключей, без регистрации, без капчи. Создан для ИИ-агентов,
CI-пайплайнов и быстрых демо-сайтов: один POST-запрос — и у твоего
хостнейма есть имя в DNS.

Базовый URL: https://w-b.pages.dev
OpenAPI-спецификация: https://w-b.pages.dev/openapi.json

## Эндпоинты

### GET /api/claim
Информация о сервисе: эндпоинты, лимиты.

### GET /api/check?name=my-demo
Проверка, свободно ли имя. Ответ:
{"ok":true,"name":"my-demo","domain":"my-demo.lylymbi.dpdns.org","available":true,"reason":null}

### POST /api/claim
Выдача поддомена. Тело:
{"name":"my-demo","target":"your.pages.dev"}

Ответ:
{"ok":true,"domain":"my-demo.lylymbi.dpdns.org","target":"your.pages.dev",
 "release_token":"<32 hex>","note":"Сохрани release_token: POST /api/release {domain, release_token} освободит имя."}

Ошибки:
- 400: некорректное имя; цель не резолвится в DNS
- 409: имя занято
- 429: рейт-лимит (5 заявок / 10 минут / IP)
- 503: лимит зоны (50 записей) достигнут

### POST /api/release
Освобождение поддомена. Тело:
{"domain":"my-demo.lylymbi.dpdns.org","release_token":"<из ответа claim>"}
Ответ: {"ok":true,"released":"my-demo.lylymbi.dpdns.org"}

### GET /api/records
Реестр всех выданных поддоменов: имя, цель, дата выдачи.

## Правила

- Имя: 1-31 символ, a-z, 0-9, дефисы; без дефиса по краям.
- Запись: CNAME, DNS-only (серый), TTL 300, на цель заявителя.
- Цель должна резолвиться в DNS на момент заявки.
- Часть имён зарезервирована (www, api, mail, ns1 и др.).
- Зона не для фишинга и спама: записи с нарушением удаляются.

## Пример для агента

```
POST /api/claim HTTP/1.1
Host: w-b.pages.dev
Content-Type: application/json

{"name":"my-demo","target":"your.pages.dev"}
```

CORS открыт (Access-Control-Allow-Origin: *), запросы возможны и из браузера.