Rétention et 410

Noryo Merchant API n'est pas une archive. Elle garde le contenu d'un résultat assez longtemps pour le relire, puis le purge.

Durées de conservation

Le libellé brut n'est pas conservé. La rétention est de 0 jour : aucune colonne du module ne peut le stocker, et il n'apparaît dans aucun journal. Seule une empreinte de sa forme canonique est gardée, pour reconnaître une transaction déjà vue.

Le 410

Passé 90 jours, une lecture rend :

{
  "type": "https://developer.noryo.app/errors/result_content_expired",
  "title": "Result content expired",
  "status": 410,
  "code": "result_content_expired",
  "detail": "The result content was purged and is no longer available.",
  "request_id": "req_…",
  "enrichment_id": "enr_ffe80956-cc3e-4e1f-b4b6-724ad231fbb7"
}

Le corps répète l'enrichment_id concerné. Il ne dit pas quelle classe de rétention s'est appliquée : c'est une information interne.

Un 410 n'est pas un 404 : il prouve que le résultat a existé et qu'il a été purgé. Un identifiant qui n'a jamais existé, ou qui appartient à un autre workspace, rend 404.

Un résultat not_found n'a pas de contenu à purger : sa lecture continue de rendre 200 avec merchant: null, jamais 410, et le renvoi de sa transaction aussi.

Le 410 sur une création

Renvoyer en POST une transaction déjà connue (même external_transaction_id, même entrée) dont le contenu courant a été purgé rend aussi 410 result_content_expired. Ce refus n'est pas facturé. Pour obtenir à nouveau un résultat lisible, rafraîchissez la transaction : voir Rafraîchir.

Ce qui survit

L'identité, la ligne de registre, les unités, le prix et les horodatages comptables survivent tous : vous pouvez toujours prouver ce que vous avez acheté et quand. Seul le contenu a disparu.

Ce qu'il vous revient de faire

Stockez de votre côté ce dont vous avez besoin. Si votre produit affiche le nom d'un marchand sur une transaction de l'an dernier, enregistrez merchant au moment où vous le recevez, avec l'enrichment_id et le request_id. Relire l'API ne remplace pas votre stockage.