Aller au contenu principal
Cloudios
Référence API

L’API Cloudios

FinOps multi-cloud (AWS, GCP, Azure) + Kubernetes pod-level + détection d’anomalies ML. Spec OpenAPI 3.1, authentification Clerk Bearer, prête pour vos intégrations.

Spec OpenAPI (JSON)Parler à un humain

Compatible Postman, Insomnia et openapi-generator (SDK TypeScript, Python, Go).

Démarrage

Authentification et premier appel

Toutes les routes exigent un token de session Clerk via l’en-tête Authorization, sauf mention explicite (webhooks signés HMAC).

Authentification

Passez votre token de session Clerk en Bearer. Les webhooks (ingestion K8s, Slack) utilisent une signature HMAC dédiée.

curl https://cloudios.io/api/clusters \
  -H "Authorization: Bearer <clerk_session_token>"

Lancer un scan

Renvoie un scan_id et un job_id immédiatement. Sondez /api/scan/{scan_id} jusqu’à complétion.

curl -X POST https://cloudios.io/api/scan \
  -H "Authorization: Bearer <clerk_session_token>" \
  -H "Content-Type: application/json" \
  -d '{ "aws_account_id": "uuid", "scan_tier": "standard" }'
https://cloudios.ioproductionhttp://localhost:3000développement local
Endpoints

Référence des endpoints

Le contrat complet — paramètres, schémas de body et codes de réponse — vit dans la spec OpenAPI.

Scans

Déclencher et suivre des scans de coûts.
POST/api/scanLancer un scan complet (renvoie un job_id immédiatement).
GET/api/scan/{scan_id}État et résultats d’un scan.

Clusters

Enregistrement Kubernetes + ingestion de métriques pod-level.
GET/api/clustersLister vos clusters.
POST/api/clustersEnregistrer un cluster (token affiché une seule fois).
GET/api/clusters/{id}Détail d’un cluster.
DELETE/api/clusters/{id}Déconnecter un cluster (cascade des métriques).
GET/api/clusters/{id}/podsMétriques pod-level (namespace, hours, limit).
POST/api/clusters/ingestPush de l’agent Helm — auth HMAC (pas Clerk).HMAC

Terraform

Analyse de coût pré-déploiement.
POST/api/terraform/analyzeAnalyser le coût d’un plan Terraform.
POST/api/terraform/pr-commentAnalyser et commenter une PR GitHub.

Jobs

Administration de la file asynchrone (DLQ, annulation, replay).
GET/api/jobs/dead-letterLister les jobs en dead-letter.
POST/api/jobs/dead-letterRejouer un job DLQ.
GET/api/jobs/{id}État d’un job.
DELETE/api/jobs/{id}Annuler un job en file ou en cours.

CloudFormation

État des stacks via STS AssumeRole.
GET/api/aws-accounts/cfn-statusÉtat d’une stack CloudFormation.

Anomalies

Streaming temps réel des anomalies (SSE).
GET/api/anomalies/streamFlux SSE — à écouter via EventSource.

Slack

Webhook de slash command Slack.
POST/api/slack/commandsCommande /cloudios — signature HMAC SHA-256 v0.HMAC

Cost Allocation

Allocation par tag cross-cloud (différenciateur Tier 4).
GET/api/cost-allocation/tagsAgréger les findings AWS+GCP+Azure+OCI+K8s par tag.

Migration ROI

Simulateur de ROI de migration cross-cloud (Tier 4).
POST/api/migration-roiDelta de coût + payback pour AWS↔GCP↔Azure↔OCI.

Prêt à intégrer Cloudios ?

Importez la spec OpenAPI dans votre outil favori ou générez un SDK typé en quelques secondes.

Télécharger la specCréer un compte