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

Последнее обновление: 2026-07-05

API hdply позволяет скриптам и ИИ-агентам управлять вашими сайтами программно: получать список проектов, читать HTML, публиковать обновления и создавать новые сайты. Это небольшой предсказуемый REST API — если вы умеете пользоваться curl, вы умеете пользоваться hdply.

Аутентификация

Создайте персональный API-ключ в консоли (карточка «API-ключ»). Передавайте его bearer-токеном в каждом запросе:

Authorization: Bearer hdply_sk_…

Ключ показывается только один раз при создании; перевыпуск заменяет его, удаление отзывает немедленно. Держите его в секрете — он даёт доступ ко всем вашим проектам.

Базовый URL

https://api.app.hdply.com

Эндпоинты

GET /v1/projects — список ваших проектов.
POST /v1/projects — создать проект. Тело JSON: {"name": "опционально", "html": "опционально"}. Если передан html, сайт сразу публикуется; без имени используется <title> из HTML. Поддомен назначается сервером случайно.
GET /v1/projects/{id} — один проект. {id} принимает числовой id или поддомен (например, k3v9x2m7q1).
GET /v1/projects/{id}/html — текущий опубликованный HTML.
PUT /v1/projects/{id}/html — опубликовать новый HTML (сырое тело text/html, сайт обновляется в момент ответа).
GET /v1/projects/{id}/deployments — история деплоев (деплои через API помечены "source": "api").

DELETE отсутствует. Удаление сайта намеренно доступно только через веб, поэтому автоматический агент никогда не уничтожит вашу работу. Каждый деплой через API версионируется — любую версию можно восстановить из консоли.

Быстрый старт

export HDPLY_KEY=hdply_sk_…

# create a site and go live in one call
curl -X POST https://api.app.hdply.com/v1/projects \
  -H "Authorization: Bearer $HDPLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<!doctype html><title>Hello</title><h1>Hi!</h1>"}'
# → {"project": {"subroute": "k3v9x2m7q1", "url": "https://k3v9x2m7q1.hdply.com", …}}

# read the live HTML
curl https://api.app.hdply.com/v1/projects/k3v9x2m7q1/html \
  -H "Authorization: Bearer $HDPLY_KEY"

# publish an update
curl -X PUT https://api.app.hdply.com/v1/projects/k3v9x2m7q1/html \
  -H "Authorization: Bearer $HDPLY_KEY" \
  -H "Content-Type: text/html" \
  --data-binary @index.html

Лимиты и ошибки

HTML ограничен 1 МБ на сайт (лучше всего один самодостаточный файл).
Бесплатный план включает 20 сайтов; Pro — без лимита.
Ошибки в JSON: {"code": "…", "error": "сообщение"}. Частые коды: unauthorized (401), project_not_found (404), project_limit (403), file_too_large (413).

Claude и MCP

В hdply встроен MCP-сервер: Claude Code и Claude Desktop могут работать с вашими сайтами как с нативными инструментами (list_sites, create_site, get_site_html, deploy_site, get_deploy_history). Подключите Claude Code одной командой:

claude mcp add --transport http hdply https://api.app.hdply.com/mcp \
  --header "Authorization: Bearer hdply_sk_…"

Для Claude Desktop добавьте это в настройки MCP (claude_desktop_config.json):

{
  "mcpServers": {
    "hdply": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.app.hdply.com/mcp",
               "--header", "Authorization: Bearer hdply_sk_…"]
    }
  }
}

Использование с ИИ-агентами

Вставьте блок ниже вместе с ключом в ChatGPT, Claude или любого агента с доступом к shell. После этого достаточно сказать «обнови мой сайт» — он будет знать как.

You can manage my hdply websites via its REST API.
Base URL: https://api.app.hdply.com
Auth header on every request: "Authorization: Bearer <MY_KEY>"

Endpoints:
- GET  /v1/projects                     -> list my sites
- POST /v1/projects                     -> create; JSON {"name"?, "html"?}; html goes live instantly
- GET  /v1/projects/{id}/html           -> current HTML ({id} = numeric id or subdomain)
- PUT  /v1/projects/{id}/html           -> publish new HTML (raw text/html body)
- GET  /v1/projects/{id}/deployments    -> version history

Rules: HTML max 1MB, single self-contained file preferred (inline CSS/JS).
There is no delete endpoint. Every deploy is versioned and restorable.
After publishing, the site is live at https://{subroute}.hdply.com immediately.

Машиночитаемое описание для краулеров и агентов: hdply.com/llms.txt