Loader Logo

Présentation

Bienvenue sur l'API Blasons de France, votre interface moderne et conviviale pour accéder aux blasons officiels et historiques des communes et régions françaises. Conçue pour faciliter l’intégration de données patrimoniales, cette API vous offre des informations fiables et structurées.

Résumé de l'initiative

L’initiative API Blasons de France vise à démocratiser l’accès aux richesses du patrimoine héraldique français. En centralisant et en structurant les informations issues des blasons, ce projet permet aux développeurs et aux passionnés d’intégrer aisément ces données dans leurs applications. Il s’inscrit dans une démarche de valorisation culturelle en rendant accessible l’héritage historique des territoires.

Crédits, les blasons et la protection du droit d'auteur

Les images et informations relatives aux blasons proviennent du Projet Blasons sur Wikimédia, et sont libres d’usage. Nous remercions chaleureusement les contributeurs qui, par leur engagement, permettent la préservation de ce patrimoine unique.

Bien que les blasons, en tant qu'emblèmes historiques, ne soient pas soumis aux règles classiques des droits d'auteur, leurs représentations graphiques relèvent des mêmes régimes juridiques que toute autre œuvre de l'esprit. Ainsi, la reproduction d'une image de blason directement extraite d'un site (par exemple celui d'une commune), sauf si elle est expressément diffusée sous une licence libre, contrevient aux principes du droit d'auteur. C'est pour cette raison que Wikipédia s'engage à élaborer une interprétation graphique libre pour chacun des blasonnements. Il convient de rappeler que l'utilisation d'une image publiée sous licence GFDL pour intégrer une partie d'une œuvre nouvelle impose que cette dernière soit également diffusée sous la même licence. De même, si un élément graphique (« meuble ») est soumis à une licence libre telle que Creative Commons ShareAlike (CC-SA), il est impossible de publier le blason résultant sous une double licence dès lors qu'il contient cet élément protégé. Il est donc conseillé de proposer vos éléments graphiques sous la licence libre la moins contraignante, par exemple Creative Commons BY (paternité) ou une double licence GFDL+Creative Commons. Cette approche permet au dessinateur réutilisant vos meubles de choisir sa propre licence sans être obligé de reproduire votre choix initial pour les éléments utilisés. Enfin, il faut noter que le blasonnement, lorsqu'il est de conception contemporaine, peut également être protégé par le Code de la propriété intellectuelle en France, à l'instar de toute autre œuvre de l'esprit. Pour plus de précisions, il convient de consulter les dispositions relatives aux blasons des collectivités territoriales françaises.

Mode d'emploi de l'API

L'API Blasons de France s’appuie sur les standards REST et fournit des réponses en format JSON. Pour accéder aux données, une clé API est nécessaire en environnement de production. Voici quelques points essentiels :

  • Endpoint de base : https://api.blasons.fr/v1
  • Format de réponse : JSON
  • Authentification : Clé API requise

Pour réaliser une requête, envoyez une requête GET à l'endpoint concerné. Par exemple, pour obtenir le blason d'une commune, utilisez : 

GET /v1/blasons?commune=Paris

Des paramètres additionnels permettent de filtrer par région, département ou période historique.

Exemples

Voici quelques exemples concrets d’utilisation de l’API :

Exemple 1 : Récupérer le blason de Paris 
curl -X GET "https://api.blasons.fr/v1/blasons?commune=Paris" -H "Authorization: Bearer YOUR_API_KEY"
Exemple 2 : Récupérer les blasons d'une région 
curl -X GET "https://api.blasons.fr/v1/blasons?region=Normandie" -H "Authorization: Bearer YOUR_API_KEY"
v1