# Référence API — Transaction Intelligence

Noryo Transaction Intelligence API · Version `2026-10-01` · Serveur `https://api.noryo.app`

D'une transaction financière brute à une intelligence structurée.

`signals.used` liste les signaux reçus qui ont été transmis au moteur — au résolveur d'identité, ou à la base pour les séries, les relations et la couverture d'observation. `signals.ignored` liste ceux que personne n'a lus. Ce champ n'est pas une commodité : sans lui, un client peut envoyer un MCC pendant des mois, recevoir 200, et croire qu'il pèse sur la réponse. 

Les nombres de cette API ne sont pas des probabilités. Une vingtaine de champs numériques ressemblent à une confiance, sous trois noms (`confidence`, `strength`, `value`). Chacun porte une extension `x-noryo-score` qui dit sa classe (`declared_constant`, `evidence_ratio`, `calendar_fill`, `anchor_stability`, `authority_tiebreak`, `text_coverage`), à quoi il est comparable, et à quoi il ne l'est pas. Le même `0.5` vaut 1/2 signal pour une paire de virement et 2/4 pour une contre-passation : il ne se compare qu'à l'intérieur de sa classe et de son type. Aucun n'est calibré — `calibration = non_calibree` partout, par contrainte — parce qu'aucun corpus réel de référence ne permet aujourd'hui de rapporter l'un de ces nombres à une fréquence observée. Les classes sont décrites dans `components.x-noryo-score-classes`. 

Le nom `confidence` (sous `resolution`) est conservé pour la compatibilité de `ti_v1`. Lisez-le comme « force déclarée du motif », jamais comme une confiance.

## Authentification

- `txnApiKey` — http bearer. Une credential de la famille `txn` : `nry_txn_sbx_<key_id>.<secret>` en Sandbox, `nry_txn_live_<key_id>.<secret>` en Production. Une clef `nry_mer_*` est refusée ici, et réciproquement : les familles sont isolées par le domaine du vérificateur, pas seulement par un filtre.

## Opérations

| Méthode | Chemin | Résumé |
| --- | --- | --- |
| `POST` | [`/transactions/v1/coverage-windows`](https://developer.noryo.app/fr-FR/transaction-intelligence/reference/declare-coverage-window) | Déclarer ce qui a été fourni pour un compte, sur une période |
| `POST` | [`/transactions/v1/enrichments`](https://developer.noryo.app/fr-FR/transaction-intelligence/reference/create-enrichment) | Enrichir une transaction. |
| `GET` | [`/transactions/v1/enrichments/{enrichment_id}`](https://developer.noryo.app/fr-FR/transaction-intelligence/reference/get-enrichment) | Relire un enrichissement rendu. |

## Erreurs

[Erreurs — Transaction Intelligence](https://developer.noryo.app/fr-FR/transaction-intelligence/errors)

## Spécification OpenAPI

[openapi.json](https://api.noryo.app/openapi.json) (JSON)

---

Page canonique : https://developer.noryo.app/fr-FR/transaction-intelligence/reference
