مساعد API

تطبيقات الحاويات

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

المصادقة

تتطلب كل نقطة نهاية رمز Bearer مقيّدًا بنطاق مستخدمك. وأسرع طريقة للحصول على واحد هي cdnctl login؛ ويعمل الرمز أيضًا مع استدعاءات curl/HTTP المباشرة من السكربتات وأنظمة 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

مثال تطبيقي: قراءة حالة تطبيق

الاستجابات بصيغة JSON. وتحمل الاستجابات غير 2xx حقلي status وmessage يوضّحان سبب الخطأ.

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

معلومات مفيدة

• هذه هي نفس نقاط النهاية التي تستخدمها اللوحة وcdnctl — أي شيء يمكنك النقر عليه، يمكنك برمجته.
• فضِّل "cdnctl container apps wait --status running" على حلقات الاستطلاع المتكررة عند أتمتة عمليات النشر.
• العمليات غير متزامنة: تُعيد الاستدعاءات المُعدِّلة عملية يمكنك متابعتها من اللوحة أو عبر نقطة نهاية الحالة.