LexDJ · Documentation

API Reference

Accès programmatique à 53 806 textes officiels du Journal Officiel de la République de Djibouti. Gratuit. Pas de clé requise.

Base URL: https://lexdj.blyanalytics.com

Rate limiting

60 requêtes par minute par adresse IP. Les requêtes dépassant cette limite retournent un statut 429.

GET/api/v1/laws

Liste paginée des textes officiels.

Paramètres

Nom	Type	Défaut	Description
page	integer	1	Numéro de page
limit	integer	20	Résultats par page (max 50)
type	string	—	Filtrer par type (Loi, Décret, Arrêté...)
ministry	string	—	Filtrer par ministère (valeur exacte)
era	string	—	colonial · independence · modern

Exemple

GET https://lexdj.blyanalytics.com/api/v1/laws?type=Loi&era=modern&limit=5

Réponse

{
  "data": [
    {
      "id": 441,
      "title": "Décret n° 2024-008/PR/SES...",
      "doc_type": "Décret",
      "reference_number": "2024-008/PR/SES",
      "ministry": "PRÉSIDENCE DE LA RÉPUBLIQUE",
      "publication_date": "2024-02-01",
      "issue_number": "n° 1 du 15/01/2024",
      "intro_text": "Le Président de la République...",
      "signed_by": "ISMAÏL OMAR GUELLEH",
      "source_url": "/texte-juridique/..."
    }
  ],
  "meta": {
    "page": 1,
    "limit": 5,
    "total": 2528,
    "total_pages": 506,
    "has_next": true,
    "has_prev": false
  }
}

GET/api/v1/laws/:id

Texte complet d'un texte par son identifiant.

Paramètres

Nom	Type	Défaut	Description
id	integer	—	Identifiant unique du texte

Exemple

GET https://lexdj.blyanalytics.com/api/v1/laws/441

Réponse

{
  "data": {
    "id": 441,
    "title": "Décret n° 2024-008/PR/SES...",
    "doc_type": "Décret",
    "full_text": "Article 1er. — ...",
    "visas_text": "Vu la Constitution...",
    "signed_by": "ISMAÏL OMAR GUELLEH",
    "pdf_links": [],
    ...
  }
}

GET/api/v1/search

Recherche plein texte dans les titres, introductions et corps des textes. Résultats classés par pertinence.

Paramètres

Nom	Type	Défaut	Description
q	string	—	Requête (obligatoire)
page	integer	1	Numéro de page
limit	integer	20	Résultats par page (max 50)
type	string	—	Filtrer par type
ministry	string	—	Filtrer par ministère
era	string	—	colonial · independence · modern

Exemple

GET https://lexdj.blyanalytics.com/api/v1/search?q=nomination+ministre&type=Décret&era=modern

Réponse

{
  "data": [
    {
      "id": 441,
      "title": "...",
      "relevance": 0.0759,
      ...
    }
  ],
  "meta": {
    "q": "nomination ministre",
    "page": 1,
    "total": 8,
    ...
  }
}

GET/api/v1/issues

Liste paginée des numéros du Journal Officiel.

Paramètres

Nom	Type	Défaut	Description
page	integer	1	Numéro de page
limit	integer	20	Résultats par page (max 50)
era	string	—	colonial · independence · modern
q	string	—	Recherche par numéro ou date

Exemple

GET https://lexdj.blyanalytics.com/api/v1/issues?era=modern&limit=10

Réponse

{
  "data": [
    {
      "issue_number": "n° 5 du 06/04/2026",
      "issue_date": "2026-04-06",
      "text_count": 1
    }
  ],
  "meta": { "page": 1, "total": 967, ... }
}

GET/api/v1/ministries

Index de tous les ministères et institutions avec le nombre de textes publiés.

Paramètres

Nom	Type	Défaut	Description
q	string	—	Recherche par nom de ministère

Exemple

GET https://lexdj.blyanalytics.com/api/v1/ministries?q=finance

Réponse

{
  "data": [
    {
      "ministry": "ACTES DU POUVOIR LOCAL",
      "text_count": 26225
    },
    ...
  ],
  "meta": { "total": 47 }
}

Codes d'erreur

Code	Signification
200	Succès
400	Paramètre invalide ou manquant
404	Ressource introuvable
429	Rate limit dépassé
500	Erreur serveur interne

Changelog

v1.0

Avril 2026

→Lancement initial de l'API
→5 endpoints : laws, laws/:id, search, issues, ministries
→Rate limiting : 60 req/min par IP
→53 806 textes indexés — 1904 à 2026

Cette API est fournie gratuitement par BLY Analytics. Les données proviennent du portail officiel du Journal Officiel de la République de Djibouti. Pour toute question : contact@blyanalytics.com