APIドキュメント
最終更新: 2026-07-05
hdply APIを使えば、スクリプトやAIエージェントがサイトをプログラムで管理できます:プロジェクト一覧、HTML取得、更新の公開、新規サイト作成。小さく予測しやすいREST APIなので、curlが使えればすぐ使えます。
認証
コンソールのダッシュボード(「APIキー」カード)で個人用APIキーを発行してください。すべてのリクエストにBearerトークンとして付与します:
Authorization: Bearer hdply_sk_…
キーは発行時に一度だけ表示されます。再発行すると置き換えられ、削除すると即座に無効になります。全プロジェクトにアクセスできるため、秘密に保管してください。
ベースURL
https://api.app.hdply.com
エンドポイント
GET /v1/projects— プロジェクトの一覧。POST /v1/projects— プロジェクト作成。JSONボディ:{"name": "任意", "html": "任意"}。htmlを渡すと即座に公開され、名前がなければHTMLの<title>が使われます。サブドメインはサーバーがランダムに割り当てます。GET /v1/projects/{id}— プロジェクト1件。{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はありません。サイトの削除は意図的にWebのみです。自動化エージェントがあなたの作品を壊すことはできません。すべての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 MBまで(CSS/JSをインライン化した単一ファイルが最適)。
- 無料プランはサイト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はコマンド1行で接続:
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_…"]
}
}
}
AIエージェントでの利用
下のブロックをキーと一緒にChatGPTやClaudeなどシェルを使えるエージェントに貼り付けてください。以降は「サイトを更新して」と言うだけで伝わります。
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