API REST publique Kyrionn
Consultez les routes documentées pour le Trust Score, les contrôles ISO 27001, les mesures NIS2 et le coffre-fort à preuves. La disponibilité dépend du périmètre Operator publié.
Démarrage rapide
En 4 étapes, récupérez votre Trust Score via l'API.
Consultez l'offre Operator
Vérifiez que l'accès API figure dans le périmètre publié avant toute souscription.
En savoir plus →Créez une clé API
Dashboard → Admin → API Keys. Sélectionnez les scopes nécessaires (ex: read:trust_score). La clé n'est affichée qu'une fois.
Authentifiez vos requêtes
Header Authorization: Bearer kyr_pk_xxx
Respectez les limites retournées
Suivez les headers de limitation et Retry-After effectivement renvoyés par l'API.
Exemple cURL
curl -H "Authorization: Bearer kyr_pk_xxx" \
https://kyrionn.com/api/public/v1/trust-score
# Réponse
{
"organization_id": "uuid",
"trust_score": 87,
"breakdown": {
"iso27001": { "score": 92, "weight": 0.30 },
"ebios_rm": { "score": 60, "weight": 0.25 },
"nis2": { "score": 85, "weight": 0.20 },
"rgpd": { "score": 80, "weight": 0.15 },
"kyrionnscan": { "score": 95, "weight": 0.10 }
},
"generated_at": "2026-04-23T16:42:00.000Z"
}Endpoints v1
| Méthode | Endpoint | Scope | Description |
|---|---|---|---|
| GET | /openapi | — | Spec OpenAPI 3.1 (pas d'auth) |
| GET | /trust-score | read:trust_score | Score consolidé + breakdown 5 axes |
| GET | /iso27001/controls | read:iso27001 | 93 contrôles ISO 27001:2022 + statuts |
| GET | /nis2/measures | read:nis2 | 10 catégories Article 21 + statuts |
| GET | /preuves | read:preuves | Liste coffre-fort (filter par framework) |
| POST | /preuves | write:preuves | Créer preuve depuis intégration externe |
Scopes disponibles
read:trust_scoreKyrionn Trust Score + breakdownread:iso27001Contrôles ISO 27001 + statutsread:nis2Mesures NIS2 Article 21read:rgpdRegistre RGPD Art. 30read:ebiosAteliers EBIOS RM v1.5read:ai_actÉvaluation EU AI Actread:hdsÉvaluation HDSread:preuvesCoffre-fort à preuveswrite:preuvesAjouter/supprimer preuvesread:integrationsStatut intégrations + auto-checksread:audit_logJournal d'activitéSécurité
- Authentification Bearer token au format
kyr_pk_* - Secret stocké uniquement comme hash SHA-256 côté serveur (jamais en clair)
- Scopes granulaires validés côté serveur à chaque requête
- Rate limit hard : 429 + header Retry-After
- Audit trail complet (méthode, path, status, durée, IP, user-agent)
- Révocation instantanée depuis le dashboard
Swagger UI interactif
Testez les endpoints en live depuis votre dashboard avec votre clé API.
Ouvrir Swagger UI (connecté)Questions fréquentes
Quelle offre est nécessaire ?
Consultez le périmètre Operator publié. L'accès API ne doit pas être supposé s'il n'est pas explicitement inclus dans les conditions affichées.
Quelle est la stabilité de l'API ?
Cette page décrit un aperçu technique. Aucun délai de compatibilité ou de dépréciation n'est promis tant qu'un engagement versionné n'est pas publié.
Puis-je créer plusieurs clés ?
Oui. Créez une clé par intégration (ex : vCISO, SIEM, BI) avec scopes et rate limits différenciés. Recommandé pour tracer l'usage et limiter le blast radius.
Puis-je utiliser l'API pour un client vCISO ?
Oui. Chaque organisation gère ses propres clés. Pour un vCISO multi-clients, créez une clé par client dans leur dashboard respectif et exploitez-les depuis votre outil consolidé.
L'API expose-t-elle des données personnelles ?
Non. Les endpoints v1 exposent des agrégats de conformité et des métadonnées (IDs de contrôles, statuts, scores). Les preuves ne contiennent que des références, pas les fichiers binaires.
Où signaler un bug ou une demande ?
contact@pk-infosec.com ou via le formulaire de feedback dans le dashboard.