Documentation de notarum

Chaque instance sert sa propre documentation sur /docs, construite à partir du contrat OpenAPI avec lequel l’API répond : elle ne peut donc pas se périmer. Cette page est la carte.

Les trois sources

Le Journal officiel

Ce qui a été publié chaque jour, par section et par date. La norme telle qu’elle est parue. À utiliser quand la date compte, ou quand il faut le texte publié exact et ses annexes.

Droit national — InfoLEG

La norme telle qu’elle est aujourd’hui, avec ses modifications. À utiliser quand vous savez quelle loi vous voulez : ley 24240 la trouve sans date.

Droit provincial — SAIJ

Ce que le Journal national ne publie jamais : 24 provinces, 81 000 normes depuis 1855. Filtrable par juridiction et selon la vigueur.

Savoir laquelle détient la réponse est la moitié du travail : une route les interroge toutes.

L’API

Lecture seule, JSON, contrat OpenAPI sur /v1/openapi.json.

Route	Ce qu’elle renvoie
`GET /v1/todo`	La même recherche sur les trois sources, étiquetée par origine
`GET /v1/ediciones/{seccion}/{fecha}`	Le sommaire d’une édition, avec ses avis
`GET /v1/avisos/{seccion}/{id}/{fecha}`	Un avis, avec son texte intégral
`GET /v1/anexos/…`	Les annexes PDF d’un avis
`GET /v1/buscar`	Recherche plein texte sur le Journal
`GET /v1/calendario/{anio}/{seccion}`	Quels jours ont eu une édition
`GET /v1/nacional`	Cherche dans les 428 000 normes nationales
`GET /v1/nacional/{id}`	Une norme nationale
`GET /v1/nacional/{id}/modificada-por`	Quelles normes ont modifié celle-ci
`GET /v1/nacional/{id}/modifica-a`	Quelles normes celle-ci a modifiées
`GET /v1/nacional/novedades?desde=`	Ce qui est apparu depuis une date
`GET /v1/provincial`	Cherche le droit provincial, par province et par vigueur
`GET /v1/provincial/{id}`	Une norme provinciale
`GET /v1/provincial/novedades?desde=`	Ce qui est apparu depuis une date
`GET /v1/salud`	État du service. Jamais fermé, jamais limité

L’authentification est un jeton créé depuis votre compte. Si l’en-tête arrive sans le mot Bearer mais avec le préfixe ntrm_ propre à notarum, il est accepté quand même : coller un jeton par-dessus un champ qui affichait déjà Bearer TU_TOKEN est une erreur qui coûte un après-midi, et le secret c’est le jeton, pas le mot.

Ce que « nouveau » veut dire

novedades répond ce que notarum n’avait pas vu, et non ce qui est récent. Les portails ajoutent des normes anciennes en permanence, et une loi de 1998 qui apparaît aujourd’hui est une nouveauté pour qui suit le catalogue. Filtrer sur la date de la norme les manquerait en silence. La réponse dit aussi si le registre remonte assez loin : completo: false signifie que la réponse est incomplète, pas qu’il ne s’est rien passé.

MCP pour les modèles

Un serveur MCP en JSON-RPC 2.0, sur /mcp pour un client distant ou via l’entrée/sortie standard pour un client local.

{
  "mcpServers": {
    "notarum": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/diegoparras/notarum:latest", "mcp"]
    }
  }
}

Les outils couvrent les trois sources : buscar_todo, edicion, aviso, buscar, calendario, rubros, nacional_buscar, nacional_norma, nacional_relaciones, nacional_tipos, provincial_buscar, provincial_norma, provincial_tipos, novedades et estado. Chacun explique ce qui manque au lieu de renvoyer une liste vide : un modèle qui reçoit une liste vide en conclut qu’il n’y a rien et passe à autre chose.

Alertes

Une recherche enregistrée qui s’exécute après chaque mise à jour et ne livre que la nouveauté.

Vous choisissez la source, ce que vous guettez et où l’envoyer : un webhook n8n, un flux Atom, ou simplement votre page de compte.
Le premier passage ne notifie rien. Créer une alerte sur un sujet ancien enverrait d’un coup tout ce qui existe depuis 1993 — le moyen le plus sûr de la faire supprimer.
Ce qui cesse de correspondre est oublié : si cela revient, c’est de nouveau une nouveauté.
Les webhooks pointant vers des réseaux internes sont refusés — loopback, plages privées, link-local et la plage de métadonnées des clouds — et les redirections ne sont pas suivies. L’adresse est fournie par qui crée l’alerte, et c’est notarum qui va la chercher.

Construire la requête

Chaque route de /docs a un panneau qui construit la requête : vous saisissez les valeurs et il produit l’URL, la ligne curl et un nœud HTTP Request n8n valide, prêt à coller.

Ce que couvrent les données

Mesuré sur les catalogues publiés, non supposé :


Normes nationales	428 380
Avec texte intégral publié par InfoLEG	environ 7 % — pour le reste, la fiche et le lien
Relations de modification	382 373 sur 103 560 normes ; 3,7 en moyenne
La norme la plus modifiée	Loi 14250 (conventions collectives), 42 427
Normes provinciales	81 403, sur 24 juridictions depuis 1855
Sections du Journal lues	3 — la quatrième liste des domaines `.ar`, pas du droit

Les listes de modifications sont limitées aux 200 plus récentes, le total réel restant affiché.