# Données et intégrations Explore les fiches documentées de Permis Online ou utilise notre API et notre serveur MCP pour retrouver leurs sources. Page : https://permis.online/donnees/ Corpus : 355 fiches publiques, avec leurs liens, sources, régions et dates lorsqu’elles sont documentées. Chaque fiche précise son contexte et les références qui documentent l’information. ## Utilisation Accès public, lecture seule, sans clé. Ne contient ni compte, ni progression d’élève, ni information privée. Citer le lien de la fiche et conserver ses sources et la portée de la vérification. Les analyses et méthodes de Permis Online sont identifiées séparément des règles officielles. ## API REST - Catalogue : https://permis.online/api/v1/ - Recherche : https://permis.online/api/v1/facts?q=permis&limit=10 - OpenAPI : https://permis.online/api/v1/openapi.json GET /api/v1/facts accepte q (300 caractères maximum), region (wallonie, bruxelles, flandre, belgique), kind (fact, expertise, organization, offer, person, professional, article, lesson, page, tool), limit (1 à 50, défaut 10), offset (0 à 10000, défaut 0). Les mots significatifs doivent tous figurer dans le titre, le contenu, les références ou le contexte lié. Le filtre Belgique sélectionne les fiches nationales. Réponse : {results: [fiches], total, limit, offset}. GET /api/v1/facts/{id} renvoie la fiche directement. Conserver l’identifiant exact renvoyé par la recherche. Les préfixes fait-, expertise-fait-, brand-, person-, offer-, professional- et page- sont suivis de 16 caractères hexadécimaux. Codes : 200 résultat, 400 paramètres invalides, 404 fiche inconnue, 405 méthode refusée, 429 limite atteinte, 503 service indisponible. ## MCP URL : https://permis.online/mcp Transport Streamable HTTP, réponses JSON, protocole 2025-11-25, sans authentification ni session persistante. Utiliser un client compatible avec ce transport et cette version. Aucun flux SSE n’est nécessaire. Outils : - search : {query: "permis wallonie"}, retourne {results: [{id, title, url}]} dans content et structuredContent. - fetch : {id: "identifiant renvoyé par search"}, retourne {id, title, text, url, metadata}. Les métadonnées incluent les sources et les dates disponibles. related contient le contexte complémentaire à lire. modified_at indique une modification de publication, distincte de verified_at. Les données publiques de marque, des offres et des professionnels sont transmises avec leur nature. Ajouter l’URL MCP à un client compatible, effectuer initialize puis notifications/initialized, puis tools/list et tools/call. ## Retrouver la version actuelle d’une information L’API et le serveur MCP donnent accès aux publications publiques de Permis Online. Les informations disponibles suivent les mises à jour du site, avec un lien vers la page d’origine et les références associées. Pour préparer une réponse ou actualiser ton outil, consulte à nouveau les fiches utiles. Tu retrouves ainsi leur version disponible, leurs sources et leurs dates. ## Réutiliser en citant la source Les contenus publics de Permis Online peuvent être consultés, cités et résumés pour documenter une réponse ou construire un outil, y compris commercial, avec une attribution visible et un lien vers la page utilisée : « Source : Permis Online ». Conserve les références, la région et les réserves qui accompagnent l’information. Indique les adaptations apportées et distingue les règles officielles des analyses, offres et contenus pédagogiques de Permis Online. Les documents et visuels de tiers restent soumis à leurs propres conditions. Pour republier intégralement un cours ou un article de Permis Online, demande une autorisation à contact@permis.online. L’accès aux données ne vaut pas partenariat ni approbation de ton service par Permis Online. ## Limites et références 120 requêtes par minute et par adresse IP, partagées entre API et MCP. En cas de réponse 429, respecter Retry-After ; 400 : corriger les paramètres ; 404 : rechercher à nouveau ; 503 : réessayer plus tard avec des tentatives bornées. Le service restitue les fiches publiées. Le champ bibliography contient les références bibliographiques citées dans les cours. - [Fiches de référence](https://permis.online/brand-facts/) - [Sources et références](https://permis.online/sources/) - [Fiches en Markdown](https://permis.online/brand-facts.md) - [Fiches en JSON](https://permis.online/.well-known/brand-facts.json) - [Index pour les assistants](https://permis.online/llms.txt) - [Données et intégrations](https://permis.online/donnees/) - [API des contenus publics de Permis Online](https://permis.online/donnees/api/) - [Serveur MCP Permis Online](https://permis.online/donnees/mcp/)