API pour développeurs

Découvrez notre widget

Pour les webmasters ou bloggueurs qui désire affichez la fête du jour à leur visiteur, un widget JavaScript à copier/coller est proposé, 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

Demandez votre clé d'accès

Veuillez nous faire parvenir votre IP à l'adresse api@fetedujour.fr pour recevoir votre clé. En échange, nous vous sollicitons pour faire connaître notre service en ajoutant un lien vers FeteduJour.fr sur votre site. 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
        }
    ]
}
	
twitter
facebook
google+
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é.