Desarrolladores

Referencia de la API

Crea y gestiona tus webs desde código.

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 plan
  • GET /sites: lista tus webs (filtra con subdomain o host)
  • POST /sites: crea una web
  • GET /sites/check?subdomain=: indica si un subdominio está libre
  • GET /sites/{site}: devuelve una web
  • PATCH /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, responde 409.
  • POST /sites/{site}/deployments: despliega (archivo o html, opcionalmente como borrador)
  • GET /sites/{site}/deployments: lista los despliegues de una web
  • GET /deployments/{deployment}: estado del despliegue
  • POST /deployments/{deployment}/retry: reintenta un despliegue que ha fallado
  • POST /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 objeto errors lista 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 cabecera Retry-After.

Más documentación