API दस्तावेज़

अंतिम अपडेट: 2026-07-05

hdply API से स्क्रिप्ट और AI एजेंट आपकी साइटें प्रोग्रामेटिक रूप से प्रबंधित कर सकते हैं: प्रोजेक्ट सूची, 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 देने पर साइट तुरंत लाइव हो जाती है; नाम न देने पर HTML का <title> उपयोग होता है। सबडोमेन सर्वर यादृच्छिक रूप से देता है।
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 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 एक कमांड से जुड़ता है:

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 या किसी भी 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