Accès et authentification

Obtenir une clé

1. Ouvrir api.lexmachine.net et saisir son adresse e-mail.
2. Cliquer sur le lien reçu par e-mail dans les 15 minutes.
3. Cliquer sur Générer ma clé, puis la copier immédiatement.

La clé doit être envoyée dans l’en-tête HTTP Authorization :

Authorization: Bearer VOTRE_CLE_API

Routes et découverte automatique

Le client peut appeler GET /api/v1/indexes pour obtenir les corpus autorisés pour sa clé et les capacités de chacun. Il n’a pas besoin de conserver cette liste localement.

{
  "indexes": [
    {
      "id": "legislation",
      "name": "Législation consolidée",
      "capabilities": {
        "modes": ["semantic", "keywords", "hybrid"],
        "default_mode": "semantic",
        "filters": [],
        "operations": ["search", "resolve", "compare", "document"],
        "document_anomaly_policy": "report"
      }
    }
  ],
  "count": 1
}

Le contrat OpenAPI permet également à ChatGPT, à un client généré ou à tout outil compatible OpenAPI de découvrir automatiquement les routes et leurs paramètres. Le profil public actif annonce resolve, compare et document pour legislation, avec document_anomaly_policy: report. Le client doit néanmoins relire GET /api/v1/indexes, car une capacité peut être coupée à chaud en cas d’incident.

Effectuer une recherche

POST /api/v1/indexes/{identifiant_du_corpus}/search
Content-Type: application/json
Authorization: Bearer VOTRE_CLE_API

Corps JSON :

{
  "query": "responsabilité de l’État pour délai excessif",
  "top_k": 5,
  "mode": "semantic"
}

• query est obligatoire ;
• top_k est optionnel et limite le nombre de passages renvoyés : maximum général 20, ou 10 pour une clé libre-service ;
• mode vaut semantic pour la recherche vectorielle, keywords pour la recherche FTS ou hybrid pour leur fusion RRF.

{
  "query": "responsabilité de l’État pour délai excessif",
  "top_k": 5,
  "mode": "hybrid"
}

curl --request POST \
  --url https://api.lexmachine.net/api/v1/indexes/jurisprudence/search \
  --header "Authorization: Bearer VOTRE_CLE_API" \
  --header "Content-Type: application/json" \
  --data '{"query":"responsabilité de l’État pour délai excessif","top_k":5,"mode":"semantic"}'

import os
import requests

response = requests.post(
    "https://api.lexmachine.net/api/v1/indexes/jurisprudence/search",
    headers={"Authorization": f"Bearer {os.environ['LEXMACHINE_API_KEY']}"},
    json={
        "query": "responsabilité de l’État pour délai excessif",
        "top_k": 5,
        "mode": "semantic",
    },
    timeout=60,
)
response.raise_for_status()
print(response.json()["hits"])

const response = await fetch(
  "https://api.lexmachine.net/api/v1/indexes/jurisprudence/search",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.LEXMACHINE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      query: "responsabilité de l’État pour délai excessif",
      top_k: 5,
      mode: "semantic",
    }),
  },
);

if (!response.ok) throw new Error(`Erreur API : ${response.status}`);
const result = await response.json();
console.log(result.hits);

Résolution documentaire exacte

La recherche classe des passages. Pour identifier précisément un article et sa version applicable à une date, utilisez resolve lorsqu’il est annoncé par GET /api/v1/indexes :

POST /api/v1/indexes/legislation/resolve
Content-Type: application/json
Authorization: Bearer VOTRE_CLE_API

{
  "article_number": "L. 3121-18",
  "parent_title": "Code du travail",
  "parent_nature": "CODE",
  "effective_date": "2026-08-11"
}

Le résultat vaut resolved, not_found ou ambiguous. L’égalité porte sur le numéro canonique, le texte parent, sa nature et l’intervalle temporel. L’état brut, les dates, le contenu intégral, son hash et l’URL Légifrance qualifiée sont rendus sans score ni fallback vectoriel.

URL qualifiée décrit la construction du bon chemin Légifrance à partir des métadonnées. Ce n’est pas un test HTTP du site externe : un 404 de Légifrance peut provenir de sa protection anti-robot et ne prouve pas, à lui seul, que le document est absent. La décision de l’API repose uniquement sur le snapshot structuré.

{
  "article_number": "L. 3121-18",
  "parent_title": "Code du travail",
  "parent_nature": "CODE",
  "dates": ["2024-01-01", "2026-08-11"]
}

Format des résultats

{
  "request_id": "req_...",
  "index": {
    "id": "jurisprudence",
    "name": "Jurisprudence officielle"
  },
  "hits": [
    {
      "rank": 1,
      "score": 0.91,
      "document_id": "...",
      "title": "...",
      "content": "Passage documentaire...",
      "source_url": "https://...",
      "metadata": {}
    }
  ],
  "count": 1,
  "retrieval": {
    "mode": "semantic",
    "elapsed_ms": 84.2
  }
}

Les champs disponibles dépendent du corpus source. content contient le passage documentaire normalisé et metadata les informations complémentaires non binaires.

Erreurs, quotas et périmètre