API REST · DOI 10.5281/zenodo.23400341

Documentation API

Une API REST ouverte, citable et documentée pour interroger les 250 biais, les 68 réglementations et les 21 vues analytiques de la base IBI.

44
Relations exposées
17
Fonctions RPC
20
Relations liées
REST
PostgREST 16.4

Endpoints

Points d'entrée principaux

L'API suit la spécification PostgREST : chaque table et chaque vue est automatiquement exposée en REST. Les filtres, tris et sélections de colonnes se font via l'URL.

MéthodeEndpointDescription
GET/biaisListe complète des 250 biais
GET/biais?ibi_id=eq.IBI-0002Filtrer par identifiant IBI
GET/v_top_biais_critiquesTop des biais les plus critiques
GET/v_api_biais_listeListe synthétique (format API)
GET/v_api_rechercheRecherche full-text
GET/reglementationsLes 68 réglementations mondiales
GET/v_api_regulationsRéglementations formatées
POST/rpc/recherche_biaisRecherche par mot-clé (RPC)
POST/rpc/recherche_triaxisRecherche par axes TriAxis (RPC)

Exemples

Utilisation rapide

Voici quelques exemples concrets pour interroger l'API. Base URL : http://localhost:3000 (dev) ou https://api.ai-biais-initiative.org (prod).

⚡Curl - Lister 10 biais

curl "http://localhost:3000/biais?limit=10"

⚡Curl - Biais par identifiant

curl "http://localhost:3000/biais?ibi_id=eq.IBI-0002"

🐍Python - Recherche via RPC

import requests

r = requests.get(
    "http://localhost:3000/rpc/recherche_biais",
    params={"terme": "proxy", "limite": 5}
)
for biais in r.json():
    print(biais["ibi_id"], "-", biais["nom_fr"])

🐍Python - Top biais critiques

import requests

r = requests.get(
    "http://localhost:3000/v_top_biais_critiques",
    params={"limit": 5}
)
for b in r.json():
    print(b["ibi_id"], b["score_ibi"], b["nom_fr"])

📚Filtres PostgREST disponibles

?limit=10 - Limite le nombre de résultats
?offset=20 - Pagination
?order=score_ibi.desc - Tri descendant
?select=ibi_id,nom_fr - Sélection de colonnes
?severite=eq.5_critique - Filtre égalité
?score_ibi=gte.8 - Filtre supérieur ou égal

Spécification

Spec OpenAPI complète

Toute l'API est décrite dans un fichier OpenAPI 3.0 généré automatiquement par PostgREST. Importable dans Postman, Swagger UI, Insomnia ou tout autre client compatible.

openapi.json
{
  "openapi": "3.0.0",
  "info": {
    "title": "AI BIAIS Initiative API",
    "version": "1.0.0",
    "description": "API REST sur les biais de l'IA"
  },
  "servers": [
    { "url": "https://api.ai-biais-initiative.org" }
  ],
  "paths": {
    "/biais": { ... },
    "/reglementations": { ... },
    "/rpc/recherche_biais": { ... }
  }
}

Citation

Citer l'API dans vos travaux

L'API dispose d'un DOI Zenodo. Merci de le citer si vous utilisez ces données dans une publication scientifique, un rapport ou un projet.

@software{sidibe_2026_ia_biais,
  author    = {SIDIBE, Mohamadou},
  title     = {AI BIAIS Initiative - API REST},
  year      = 2026,
  publisher = {Zenodo},
  version   = {1.0.0},
  doi       = {10.5281/zenodo.23400341},
  url       = {https://doi.org/10.5281/zenodo.23400341}
}

Construisons ensemble

Vous utilisez l'API? Vous avez des suggestions? Vous voulez contribuer à enrichir la base? Contactez-nous.