Entrées API Chronoscript & API de soumission contrôlée

STATUT

Entrées API est une surface native d’admission Chronoscript. La réception externe est désactivée par défaut et exige une configuration explicite ainsi qu’une clé API. Control affiche Entrées API que la réception soit activée ou désactivée.

ENDPOINT

POST /api/v1/chronoscript/submissions
En-têtes : X-API-Key ; Idempotency-Key recommandé. Content-Type : application/json. Le schéma de requête est /schemas/chronoscript-submission.schema.json.

FRONTIÈRE

Une requête API crée uniquement une Entrée API NON CANONIQUE. Elle ne peut attribuer ni Registry Sequence, ni Record ID, ni finalité canonique, ni coordonnées d’inscription, ni empreintes canoniques. La revue LXKeys et le workflow Chronoscript normal restent obligatoires.

FLUX

Entrée API -> validation du schéma -> attente de revue LXKeys -> acceptation comme brouillon modifiable ou rejet -> validation Chronoscript normale -> finalisation canonique explicite. L’identité de l’Entrée API reste traçable vers le brouillon puis, après finalisation, vers le record CS-n obtenu.

SÉMANTIQUE

Un client soumet un type fondamental et des données structurées. Les profils sémantiques sont résolus et validés par LXKeys. Des relations versionnées peuvent être fournies selon le référentiel publié à /api/v1/chronoscript/relations.

IDEMPOTENCE, STATUTS ET ERREURS

Les clients DEVRAIENT fournir un Idempotency-Key pour les reprises. Les requêtes acceptées reçoivent un identifiant d’Entrée API et le SHA-256 du payload. Réponses représentatives : 202 acceptée ; 400 payload invalide ; 401 clé API absente/invalide ; 429 limite de débit ; 503 API désactivée. Les limites opérationnelles sont publiées par la configuration active du service.

AUTORITÉ

La compatibilité API ne confère jamais l’autorité d’émission canonique. Un site tiers ne peut pas créer directement un CS-n. Les noms de relations enregistrent des relations déclarées et ne déterminent pas à eux seuls un effet juridique.