Public API

Ayudante de API

Estos endpoints son los equivalentes de API de los flujos de Container App y Object Storage en el panel. Todas las solicitudes se ejecutan dentro del ámbito de la cuenta CDN autorizada.

Volver a la Ayuda de la Plataforma

Container Apps

GET    /api/accounts/{uuid}/platform/container/apps
POST   /api/accounts/{uuid}/platform/container/apps
PATCH  /api/accounts/{uuid}/platform/container/apps/{app_uuid}
GET    /api/accounts/{uuid}/platform/container/registry-credentials
POST   /api/accounts/{uuid}/platform/container/registry-credentials
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/deploy
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/restart
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/scale
GET    /api/accounts/{uuid}/platform/container/apps/{app_uuid}/status
GET    /api/accounts/{uuid}/platform/container/apps/{app_uuid}/logs
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/imports/database
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/imports/files
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/scheduled-jobs
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/scheduled-jobs/{job_uuid}/run
DELETE /api/accounts/{uuid}/platform/container/apps/{app_uuid}

Object Storage

GET    /api/accounts/{uuid}/platform/container/object-storage/buckets
POST   /api/accounts/{uuid}/platform/container/object-storage/buckets
POST   /api/accounts/{uuid}/platform/container/object-storage/access-keys
POST   /api/accounts/{uuid}/platform/container/object-storage/access-keys/{key_uuid}/rotate
DELETE /api/accounts/{uuid}/platform/container/object-storage/access-keys/{key_uuid}
POST   /api/accounts/{uuid}/platform/container/apps/{app_uuid}/object-storage/bindings

Autenticación

Cada endpoint requiere un token Bearer con el alcance de tu usuario. La forma más rápida de obtenerlo es cdnctl login; el mismo token sirve para llamadas curl/HTTP directas desde scripts y CI.

# 1) authenticate once (stores the token in ~/.cdnctl/config.json)
cdnctl login --email you@example.com

# 2) call any endpoint directly with the same Bearer token
curl -H "Authorization: Bearer $TOKEN" \
  https://cdn.com.tr/api/accounts/{uuid}/platform/container/apps

Ejemplo práctico: leer el estado de una app

Las respuestas son JSON. Las respuestas distintas de 2xx incluyen los campos status y message que explican qué falló.

curl -H "Authorization: Bearer $TOKEN" \
  https://cdn.com.tr/api/accounts/{uuid}/platform/container/apps/{app_uuid}/status

# response (abridged)
{
  "status": "success",
  "app": { "uuid": "…", "name": "web", "status": "running", "replicas": 1 }
}

Bueno saber

Son los mismos endpoints que usan el panel y cdnctl: todo lo que puedes pulsar, puedes automatizarlo.
Prefiere "cdnctl container apps wait --status running" en lugar de bucles de sondeo al automatizar despliegues.
Las operaciones son asíncronas: las llamadas que modifican devuelven una operación que puedes seguir desde el panel o el endpoint de estado.