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.
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éthode | Endpoint | Description |
|---|---|---|
| GET | /biais | Liste complète des 250 biais |
| GET | /biais?ibi_id=eq.IBI-0002 | Filtrer par identifiant IBI |
| GET | /v_top_biais_critiques | Top des biais les plus critiques |
| GET | /v_api_biais_liste | Liste synthétique (format API) |
| GET | /v_api_recherche | Recherche full-text |
| GET | /reglementations | Les 68 réglementations mondiales |
| GET | /v_api_regulations | Réglementations formatées |
| POST | /rpc/recherche_biais | Recherche par mot-clé (RPC) |
| POST | /rpc/recherche_triaxis | Recherche 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 égalSpé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": "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.