API DZ·LEX — Intégration

Toute la plateforme (recherche, textes, assistant IA, graphe, chronologie) est accessible en HTTP + JSON. Base : https://jordap.legal-index.com

1 · Authentification

Envoyez votre clé sur chaque requête via l'en-tête Authorization: Bearer sk_…. La clé hérite de votre formule (un compte abonné ⇒ appels illimités).

Générez votre clé depuis Mon compte, puis rechargez cette page pour l'insérer dans les exemples.

Les appels anonymes (sans clé) fonctionnent aussi, mais sont limités par adresse IP.

2 · Quotas & limites

Formule	Recherches	Questions IA
Anonyme (par IP)	50	5
Compte gratuit	100	10
Abonné	illimité	illimité

Quota épuisé ⇒ HTTP 402. Le corps porte un code à traiter côté client : signup_required (créer un compte) ou upgrade_required (s'abonner).

// 402 Payment Required
{
  "detail": {
    "code": "upgrade_required",
    "kind": "search",
    "limit": 100,
    "message": "Quota gratuit épuisé…"
  }
}

3 · Endpoints

GET/api/search?q=divorce&page_size=5

Recherche plein-texte

Recherche dans tout le corpus (lois, décrets, jurisprudence). Renvoie hits + facettes. Compté comme une « recherche ».

curl "https://jordap.legal-index.com/api/search?q=divorce&page_size=5" \
  -H "Authorization: Bearer sk_VOTRE_CLE"

GET/api/search/articles?q=702

Recherche par article

Numéro d'article (« 702 », « 121 bis ») ou texte libre. Les articles de code remontent en tête.

curl "https://jordap.legal-index.com/api/search/articles?q=702" \
  -H "Authorization: Bearer sk_VOTRE_CLE"

GET/api/texts/LOI-84-11

Détail d'un texte

Texte complet + articles, statut, chronologie, relations. `ref` = clé canonique (URL-encodée).

curl "https://jordap.legal-index.com/api/texts/LOI-84-11" \
  -H "Authorization: Bearer sk_VOTRE_CLE"

POST/api/ask

Assistant juridique (IA / RAG)

Question en langage naturel. Réponse citée à partir des sources officielles. Compté comme une « question IA ».

curl -X POST "https://jordap.legal-index.com/api/ask" \
  -H "Authorization: Bearer sk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"question":"Quelles sont les conditions du divorce ?"}'

GET/api/stats

Statistiques du corpus

Compteurs globaux (textes, relations, JO…). Aucun quota.

curl "https://jordap.legal-index.com/api/stats"

4 · Codes de réponse

200 — succès (JSON).
401 — endpoint protégé sans authentification.
402 — quota épuisé (voir §2).
404 — ressource inconnue (ex. ref introuvable).
422 — paramètres invalides.

← Ma clé d'API & mon compte