API pour développeurs

La fête du jour sur votre site ou votre application

Vous pouvez récupérer très facilement la fête du jour via notre API. La fête du jour est accessible à cette adresse :

Modération dans les requêtes

Veuillez prendre soin de ne pas faire appel à l'API inutilement, requettez de façon intelligente et enregistrez le résultat pour le reste de la journée.

Obtenez la fête du jour que vous voulez

Vous pouvez préciser les jour et mois voulus. Par exemple le 10 mai :

Ces paramètres sont optionnels, s'ils ne sont pas précisés, le jour et le mois courant sont utilisés.

Choississez les prénoms ou les saints

Le deuxième paramètre permet de récupérer le prénom ou l'événement du jour, ou bien de récupérer la liste des saints. Exemples :

Différents formats possibles

Quatre formats d'échange sont possibles : texte, JSON, XML ou HTML. Pour ce faire, spécifiez le format désiré en paramètre : "text", "json","xml" ou "html".

Exemple de réponse

Requête : http://fetedujour.fr/api/v2/VOTRECLE/xml-normal.

Détails sur le format XML

		# Pour un type normal
<holiday>
    <day>JOUR</day>
    <month>MOIS</month>
    <name>PRENOM</name>
</holiday>

# Pour le type saints
<holiday>
    <day>28</day>
    <month>4</month>
    <saints>
        <saint>
            <name>NOM DU SAINT</name>
            <gender>M|F</gender>
        </saint>
    </saints>
</holiday>
	

Détails sur le format JSON

		# Pour un type normal
{
    "day":28,
    "month":4,
    "name":"Val\u00e9rie"
}

# Pour le type saints
{
    "day":JOUR,
    "month":MOIS,
    "saints":[
        {
            "name":NOM DU SAINT,
            "gender":M|F
        }
    ]
}