Intégrations

API

Lire votre parc et envoyer des rapports depuis vos propres outils. Incluse dans l’offre MSP.

Créer une clé

Dans Réglages → API, créez une clé, limitée au compte entier ou à un client. Elle n’est affichée qu’une fois : rangez-la dans votre coffre de secrets.

Permission	Donne accès à
`read`	consultation du parc, du calendrier, des rapports et des PDF
`manage`	gestion des clients, sites, tâches, canaux, tickets et éditions
`ingest`	envoi de rapports uniquement, sans lecture

Envoyer un rapport

Chaque exécution porte un identifiant unique (Idempotency-Key) : renvoyer le même identifiant ne crée pas de doublon.

Envoi d’un compte rendu

curl https://soluax.ai/api/v1/reports \
  -H "Authorization: Bearer $SOLUAX_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: srv-fichiers-2026-10-12" \
  --data '{"jobId":"JOB_ID","observedAt":"2026-10-12T05:00:00Z","text":"Status: Success"}'

La date d’exécution doit dater de moins de 90 jours. Les rapports envoyés par l’API ouvrent et ferment les tickets comme ceux reçus par e-mail.

Référence complète

Le contrat OpenAPI liste toutes les routes et leurs paramètres : /api/v1/openapi. Limite : 300 requêtes par minute et par clé.