API pour développeurs

Découvrez notre widget

Pour les webmasters ou bloggueurs qui désirent afficher la fête du jour à leurs visiteurs, un widget JavaScript à copier/coller est disponible, cliquez-ici pour tout savoir

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 :

http://fetedujour.fr/api/v2/VOTRECLE/text-normal

Générez votre clé d'accès

IP qui appelera l'api :

Attention, seules les IP fixes sont acceptées.

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 :

http://fetedujour.fr/api/v2/VOTRECLE/text-normal-10-5.

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 :

http://fetedujour.fr/api/v2/VOTRECLE/text-normal-10-5 http://fetedujour.fr/api/v2/VOTRECLE/text-saints-10-5

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".

http://fetedujour.fr/api/v2/VOTRECLE/json-normal-10-5

Détails des paramètres de l'url d'appel

Notre API respecte le format suivant :

  • http://fetedujour.fr/api/v2/VOTRECLE/FORMAT-TYPE-JOUR-MOIS
  • VOTRECLE : la clé que nous vous avons attribué, obligatoire.
  • FORMAT : xml|json|text|html, obligatoire.
  • TYPE : normal|saints, optionnel.
  • JOUR : 1-31, optionnel.
  • MOIS : 1-12, optionnel.

Si des paramètres sont manquants, nous prendrons les valeurs par défaut (jour et mois courant, type normal). Si vous désirez une date précise, vous devez obligatoirement fournir le jour et le mois dans l'url.

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
        }
    ]
}
	
Fête du Jour sur votre site

Fetedujour.fr vous permet d'afficher très facilement sur votre site la fête du jour.

Que vous soyez développeur, webmaster ou simple blogger, nous vous permettons d'afficher le prénom à souhaiter ou les saints du jour dans un site internet, une application mobile ou pour tablette.

Utilisez notre API ou le widget JavaScript . Ce service étant gratuit, un simple lien vers Fetedujour.fr est apprécié.