Documentation de l’API

Dernière mise à jour : 2026-07-05

L’API hdply permet aux scripts et agents IA de gérer vos sites par programmation : lister les projets, lire le HTML, publier des mises à jour et créer de nouveaux sites. C’est une petite API REST prévisible — si vous savez utiliser curl, vous savez utiliser hdply.

Authentification

Créez votre clé API personnelle dans le tableau de bord de la console (carte « Clé API »). Envoyez-la comme jeton bearer à chaque requête :

Authorization: Bearer hdply_sk_…

La clé n’est affichée qu’une fois à la création ; la régénérer la remplace, la supprimer la révoque immédiatement. Gardez-la secrète — elle donne accès à tous vos projets.

URL de base

https://api.app.hdply.com

Endpoints

GET /v1/projects — liste vos projets.
POST /v1/projects — crée un projet. Corps JSON : {"name": "optionnel", "html": "optionnel"}. Avec html, le site est en ligne immédiatement ; sans nom, le <title> du HTML est utilisé. Le serveur attribue un sous-domaine aléatoire.
GET /v1/projects/{id} — un projet. {id} accepte l’id numérique ou le sous-domaine (ex. k3v9x2m7q1).
GET /v1/projects/{id}/html — le HTML actuellement en ligne.
PUT /v1/projects/{id}/html — publie un nouveau HTML (corps text/html brut, en ligne dès le retour de la réponse).
GET /v1/projects/{id}/deployments — historique des déploiements (ceux via API portent "source": "api").

Il n’y a pas de DELETE. La suppression d’un site est volontairement réservée au web : un agent automatisé ne peut jamais détruire votre travail. Chaque déploiement API est versionné — restaurez n’importe quelle version depuis la console.

Démarrage rapide

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

Limites et erreurs

Le HTML est limité à 1 Mo par site (un fichier unique autonome fonctionne le mieux).
Le plan gratuit inclut 20 sites ; Pro est illimité.
Les erreurs sont en JSON : {"code": "…", "error": "message"}. Codes courants : unauthorized (401), project_not_found (404), project_limit (403), file_too_large (413).

Claude et MCP

hdply intègre un serveur MCP : Claude Code et Claude Desktop peuvent utiliser vos sites comme outils natifs (list_sites, create_site, get_site_html, deploy_site, get_deploy_history). Connectez Claude Code en une commande :

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

Pour Claude Desktop, ajoutez ceci à votre configuration MCP (claude_desktop_config.json) :

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

Utilisation avec des agents IA

Collez le bloc ci-dessous dans ChatGPT, Claude ou tout agent avec accès shell, avec votre clé. Ensuite, dites simplement « mets à jour mon site » et il saura faire.

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.

Résumé lisible par machine pour crawlers et agents : hdply.com/llms.txt