La API REST de DeployFast te permite controlar toda tu infraestructura desde scripts, pipelines CI/CD o agentes de IA. Puedes gestionar proyectos, disparar deploys, leer logs, configurar variables de entorno y manejar bases de datos.

Todas las peticiones deben incluir una API Key en el header Authorization. Genera tus claves en Mi cuenta → API Keys.

Authorization: Bearer dfk_live_a3f8c21e9b047d6e...

Tipos de clave

Errores de autenticación

Despliega un proyecto en 4 comandos:

# 1. Obtén tu API key en /account → API Keys

# 2. Crea un proyecto
curl -X POST https://deployfast.app/api/v1/projects \
  -H "Authorization: Bearer $DEPLOYFAST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"mi-app","repoUrl":"https://github.com/tu/repo","branch":"main"}'

# 3. Dispara el primer deploy
curl -X POST https://deployfast.app/api/v1/projects/{id}/deploy \
  -H "Authorization: Bearer $DEPLOYFAST_KEY"

# 4. Consulta el estado
curl https://deployfast.app/api/v1/deployments/{deploymentId} \
  -H "Authorization: Bearer $DEPLOYFAST_KEY"
# → {"status":"SUCCESS","url":"https://mi-app--usuario.deployfast.app"}

Configura un comando que se ejecuta dentro del contenedor recién arrancado, justo después de que el deploy sea exitoso. Ideal para migraciones de base de datos, seeding o cualquier tarea de inicialización.

Cómo configurarlo

1. Ve a /projects/:id/settings
2. Sección "Pipeline" → "Post-deploy command"
3. Escribe el comando y guarda

# Migraciones con Prisma
npx prisma migrate deploy

# Migraciones con Django
python manage.py migrate

# Seed de base de datos
npm run db:seed

# Múltiples comandos
npx prisma migrate deploy && npm run db:seed

Después de cada deploy exitoso, DeployFast hace un GET a tu app para verificar que responde con HTTP 2xx. Si no responde correctamente, el deployment queda en DEGRADED en lugar de SUCCESS. El contenedor sigue corriendo — solo es un aviso.

Flujo de estados

BUILDING → SUCCESS → smoke test → SUCCESS ✓ o DEGRADED ⚠

Configurar Health Check URL

Por defecto el smoke test llama a la URL raíz. Para usar un endpoint específico: /projects/:id/settings → Pipeline → Health Check URL.

Ejemplo de endpoint /health

// Express
app.get('/health', (req, res) => res.json({ ok: true }));

# FastAPI
@app.get('/health')
def health(): return {'ok': True}

# Django (urls.py)
path('health', lambda r: JsonResponse({'ok': True})),

DeployFast está diseñado para ser usado por agentes de IA como Cursor, Claude o Windsurf. Dale tu API key al agente y podrá gestionar tus deploys directamente desde el editor.

DEPLOYFAST_KEY=dfk_live_tu_clave_aqui

Tienes acceso a DeployFast via API en https://deployfast.app/api/v1
Authorization: Bearer $DEPLOYFAST_KEY

Puedes:
- Listar proyectos: GET /projects
- Ver estado del último deploy: GET /projects/:id
- Hacer deploy: POST /projects/:id/deploy
- Ver logs si falla: GET /deployments/:id/logs?lines=100
- Rollback: POST /deployments/:id/rollback
- Gestionar env vars: PUT /projects/:id/env/:KEY

{
  "name": "deployfast_deploy",
  "description": "Dispara un deploy en DeployFast para un proyecto",
  "parameters": {
    "project_id": { "type": "string", "description": "ID del proyecto" },
    "branch": { "type": "string", "description": "Rama a desplegar (default: main)" }
  }
}

DeployFast termina TLS en el edge (nginx) y reenvía las peticiones a tu contenedor por HTTP interno. Tu app recibe las cabeceras X-Forwarded-Proto, X-Forwarded-Host y X-Forwarded-For con los valores reales. Para que tu framework confíe en ellas debes indicárselo explícitamente.

# start command generado automáticamente:
uvicorn main:app --host 0.0.0.0 --port 3000 --proxy-headers --forwarded-allow-ips=*

# En tu app Flask (app.py)
from werkzeug.middleware.proxy_fix import ProxyFix
app.wsgi_app = ProxyFix(app.wsgi_app, x_proto=1, x_host=1)

SECURE_PROXY_SSL_HEADER=HTTP_X_FORWARDED_PROTO,https
USE_X_FORWARDED_HOST=True

// En tu app Express
app.set('trust proxy', true);

// O con variable de entorno (sin tocar código):
// TRUST_PROXY=1  →  añádela en Settings → Env Vars
// y en tu app:
if (process.env.TRUST_PROXY) app.set('trust proxy', true);

# config/environments/production.rb
config.force_ssl = true
config.action_dispatch.trusted_proxies = [ "127.0.0.1", ::1 ]

Crea y gestiona bases de datos PostgreSQL y Redis directamente desde tu código o agente.

# Crear una base de datos PostgreSQL
curl -X POST https://deployfast.app/api/v1/databases \
  -H "Authorization: Bearer $DEPLOYFAST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"mi-postgres","engine":"POSTGRES","version":"16"}'
# → {"id":"db_xxx","status":"PROVISIONING",...}

# Consultar estado (esperar RUNNING)
curl https://deployfast.app/api/v1/databases/db_xxx \
  -H "Authorization: Bearer $DEPLOYFAST_KEY"
# → {"status":"RUNNING","internalHost":"postgres-mi-postgres.user-42.internal",...}