Public API

Aide API

Ces endpoints sont les équivalents API des flux Container App et Object Storage dans le panneau. Toutes les requêtes s'exécutent dans le périmètre du compte CDN autorisé.

Retour à l'Aide Plateforme

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

Authentification

Chaque endpoint requiert un jeton Bearer associé à votre utilisateur. Le plus simple est cdnctl login ; ce jeton fonctionne aussi pour des appels curl/HTTP directs depuis des scripts et la 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

Exemple concret : lire l'état d'une application

Les réponses sont en JSON. Les réponses non-2xx contiennent les champs status et message qui expliquent l'erreur.

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 }
}

Bon à savoir

Ce sont les mêmes endpoints que le panneau et cdnctl utilisent : tout ce qui est cliquable est scriptable.
Préférez "cdnctl container apps wait --status running" aux boucles de sondage serrées lors de l'automatisation des déploiements.
Les opérations sont asynchrones : les appels modifiant l'état renvoient une opération que vous pouvez suivre depuis le panneau ou l'endpoint de statut.