Armorial des communes de France

Blasons

Une adresse, une image. L'API renvoie le blason d'une commune française à partir de son numéro de département et de son nom.

https://blasons.imay.fr/v1/city/{département}/{commune}

17 800 blasons servis
0 clé d'API requise
3 formats : SVG, PNG, JPG

Essayer

Département Commune

https://blasons.imay.fr/v1/city/31/Toulouse

Armorial

Huit communes prises au hasard du stock. Cliquez pour les charger dans l'exemple.

Mode d'emploi

Un seul point d'entrée. Pas de clé, pas d'inscription, pas de quota. La réponse est le fichier image lui-même : à poser directement dans un <img>.

GET https://blasons.imay.fr/v1/city/{code_département}/{commune}

Paramètres
Paramètre	Exemple	Détail
`code_département`	`31`	Les deux premiers chiffres du code postal.
`commune`	`Labège`	Le nom de la commune. Les accents sont ignorés : `Labege` fonctionne aussi.

Réponses
Code	Signification	Corps
`200`	Blason trouvé	le fichier image de la commune
`404`	Commune absente du stock	un écu vide, en-tête `X-Blasons-Fallback: 1`
`400`	URL incomplète ou catégorie inconnue	un écu vide

Les réponses 404 et 400 contiennent malgré tout un écu vide : un <img> qui ne teste pas le code de statut affiche quelque chose plutôt qu'une image cassée.

En ligne de commande

curl -o toulouse.svg \
  https://blasons.imay.fr/v1/city/31/Toulouse

Dans une page

<img src="https://blasons.imay.fr/v1/city/31/Toulouse"
     alt="Blason de Toulouse" width="120">

En PHP

$url = "https://blasons.imay.fr/v1/city/"
     . substr($zip_code, 0, 2) . "/" . $city;

En JavaScript

const url = `https://blasons.imay.fr/v1/city/`
  + `${dept}/${encodeURIComponent(commune)}`;

Ce que l'API ne fait pas

Autant le dire tout de suite, cela évite de le découvrir à l'usage.

Une image, rien d'autre. Pas de JSON, pas de métadonnées, pas de blasonnement, pas de recherche, pas de liste.
Le stock a des trous. Une commune absente répond 404. Paris, par exemple, n'existe qu'en arrondissements.
Le poids varie beaucoup. De 658 octets à 2,6 Mo selon le dessin. Redimensionnez à l'affichage, ne servez pas un SVG de 2,6 Mo en vignette.
Écus et drapeaux se mélangent. Certaines communes sont représentées par un drapeau rectangulaire plutôt que par un écu.
Aucune garantie de service. C'est un projet personnel, hébergé sur un serveur personnel.

Crédits et droit d'auteur

Les images proviennent du Projet Blasons de Wikimédia, où elles sont librement réutilisables. Merci aux contributeurs qui redessinent, un à un, les armoiries des communes françaises.

Les blasons, en tant qu'emblèmes historiques, échappent aux règles classiques du droit d'auteur ; leurs représentations graphiques, elles, relèvent du même régime que toute autre œuvre de l'esprit. Reproduire l'image d'un blason prise sur le site d'une commune, sans licence libre explicite, contrevient au droit d'auteur. C'est pourquoi Wikipédia produit une interprétation graphique libre de chaque blasonnement.

Réutiliser une image sous licence GFDL impose de diffuser l'œuvre dérivée sous la même licence. De même, un meuble sous Creative Commons ShareAlike interdit de publier en double licence le blason qui l'incorpore. Pour un dessinateur, la licence la moins contraignante — CC BY, ou GFDL et Creative Commons ensemble — laisse le plus de liberté à ceux qui réutiliseront le travail.

Enfin, un blasonnement de conception contemporaine peut lui-même être protégé par le Code de la propriété intellectuelle.