La API de Droply te permite crear webs y lanzar despliegues desde tus propios scripts y desde las
integraciones (la GPT Action de ChatGPT, n8n, VS Code y la extensión de Chrome usan esta misma API).
La especificación en formato legible por máquina está en
/api/v1/openapi.json (OpenAPI 3.1).
URL base
https://droply.host/api/v1
Autenticación
Crea un token de acceso personal en tu panel, en API tokens, y envíalo como token bearer en cada petición. Para usar la API necesitas un plan de pago.
Authorization: Bearer YOUR_TOKEN
Para comprobar un token en cualquier momento:
curl https://droply.host/api/v1/user \ -H "Authorization: Bearer YOUR_TOKEN"
Los tokens que creas en la página API tokens tienen Full access (acceso total), que es lo que hace falta para cambiar los ajustes de una web, borrarla, publicar un borrador o volver a una versión anterior. Los tokens de solo despliegue que crean las extensiones del navegador y del editor al iniciar sesión desde ellas pueden crear webs y desplegar, y nada más.
Crear una web
Reserva un subdominio, que se sirve en <subdomain>.droply.id. Si no envías
subdomain, Droply elige uno libre por ti.
curl -X POST https://droply.host/api/v1/sites \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"subdomain":"my-portfolio","name":"My Portfolio"}'
Buscar una web
Los ids de web y de despliegue son UUID. Para encontrar el id de una web sin recorrer toda la lista, fíltrala por subdominio o por la dirección que escribe el visitante (su dirección en Droply o un dominio propio conectado):
curl "https://droply.host/api/v1/sites?subdomain=my-portfolio" \ -H "Authorization: Bearer YOUR_TOKEN" curl "https://droply.host/api/v1/sites?host=www.example.com" \ -H "Authorization: Bearer YOUR_TOKEN"
Desplegar
Sube un archivo (un HTML, el ZIP de una web estática, un PDF o una imagen) o envía el HTML directamente.
La extensión del archivo decide cómo se sirve, así que envíalo con su nombre real. El procesamiento es
asíncrono: la llamada responde 202 con un despliegue que puedes consultar hasta que esté listo.
# Subir el ZIP de una web estática curl -X POST https://droply.host/api/v1/sites/SITE_ID/deployments \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "[email protected]" # …o publicar el HTML directamente (hasta 12 MB; una página más grande se envía como archivo) curl -X POST https://droply.host/api/v1/sites/SITE_ID/deployments \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"html":"<!doctype html><h1>Hello</h1>"}'
Consultar el estado del despliegue
Consulta hasta que status pase a live (entonces la respuesta ya incluye
live_url) o a failed (el motivo viene en error_message).
curl https://droply.host/api/v1/deployments/DEPLOYMENT_ID \ -H "Authorization: Bearer YOUR_TOKEN"
Borradores, publicación y rollback
Añade draft a un despliegue para guardar la versión sin ponerla en línea: se procesa y se
analiza, y queda en espera como staged mientras la web sigue sirviendo lo mismo que antes.
Publícala cuando quieras, o vuelve a poner en línea una versión anterior. Las dos llamadas responden
202 mientras el cambio está en cola; consulta el despliegue hasta que esté en live.
# Guardar un borrador (en multipart se envía draft=1) curl -X POST https://droply.host/api/v1/sites/SITE_ID/deployments \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "[email protected]" -F "draft=1" # Publicarlo curl -X POST https://droply.host/api/v1/deployments/DEPLOYMENT_ID/publish \ -H "Authorization: Bearer YOUR_TOKEN" # Volver a una versión anterior (cualquier despliegue ya sustituido) curl -X POST https://droply.host/api/v1/deployments/DEPLOYMENT_ID/rollback \ -H "Authorization: Bearer YOUR_TOKEN"
Contraseña y caducidad automática
Solo cambia lo que envías. password_protected: false quita la contraseña;
expires_at acepta una fecha y hora ISO 8601 con su zona horaria, o null para
quitar el temporizador.
curl -X PATCH https://droply.host/api/v1/sites/SITE_ID \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"password":"s3cret-preview","expires_at":"2026-12-01T18:00:00Z"}'
Endpoints
GET /user: la cuenta autenticada y su planGET /sites: lista tus webs (filtra consubdomainohost)POST /sites: crea una webGET /sites/check?subdomain=: indica si un subdominio está libreGET /sites/{site}: devuelve una webPATCH /sites/{site}: cambia el nombre, la contraseña o la caducidad automática (Full access)DELETE /sites/{site}: borra una web (Full access). Una web que está en un espacio protegido contra borrados accidentales solo se puede borrar desde el panel. Una web retirada, o con una versión retenida para una revisión de seguridad, responde409.POST /sites/{site}/deployments: despliega (archivo o html, opcionalmente como borrador)GET /sites/{site}/deployments: lista los despliegues de una webGET /deployments/{deployment}: estado del desplieguePOST /deployments/{deployment}/retry: reintenta un despliegue que ha falladoPOST /deployments/{deployment}/publish: publica un borrador (Full access)POST /deployments/{deployment}/rollback: vuelve a poner en línea una versión anterior (Full access)
Errores y límites
401: falta el token o no es válido.403: tu plan no incluye acceso a la API o a esta función, o el token no tiene permiso para hacer esto (algunas acciones necesitan un token con Full access).404: el recurso no existe o no es tuyo.409: la acción no se aplica a esa versión (por ejemplo, publicar una versión que no es un borrador).413: la subida supera lo que admite una sola petición (100 MB).422: la validación ha fallado (un objetoerrorslista los campos).429: has superado el límite de peticiones. El límite se aplica por token, y publicar borradores y volver a versiones anteriores está limitado a 30 por hora y cuenta. Espera los segundos que indique la cabeceraRetry-After.
Más documentación
- Crear y editar páginas con IA: Describe una página y publícala, o dile al creador qué cambiar en una web ya publicada. Cuánto cuesta y qué se niega a hacer.
- Publicar un proyecto hecho con IA: Lovable, bolt.new, v0 y Cursor te dan código fuente. Un paso de exportación lo convierte en una web.
- Enviar una versión para revisión: Envía una dirección privada con una versión, recibe los comentarios sobre el elemento al que se refieren y respóndelos.
- Publicar desde Claude: Conecta Claude y deja que publique páginas y webs en tu cuenta, en todos los planes.
- Toda la documentación: el índice completo, con las guías para conectar tu dominio.