Nous proposons deux types d'accès à l'information des horaires des événements solaires :

  • lien d'accès direct au site pour une localisation précise ;
  • appel à notre API afin d'intégrer de façon transparente le résultat sur votre propre site Internet (en cours de développement).

Lien

Ce lien permet d'accéder directement aux informations d'un lieu sur ce site. Cet appel est totalement gratuit et ne nécessite aucun développement. Il suffit d'intégrer le lien ci-dessous sur votre site Web :

https://sunset.pays-guide.com?id=ID_DU_LIEU

Paramètres

Paramètres Requis Description
id X Identifiant de la localité dans notre base de données. Voir « Comment connaitre l'identifiant d'un lieu ? » ci-dessous.
month Numéro du mois de 1 à 12. En l'absence de ce paramètre et en présence du paramètre year, c'est l'intégralité de l'année choisie qui sera affichée.
Pour afficher le mois en cours, passez le paramètre « current ». Exemple : month=current affichera toujours le mois en cours.
year Numéro de l'année sur 4 chiffres. En l'absence de ce paramètre et en présence du paramètre month, c'est le mois de l'année en cours qui sera affiché.

En l'absence des paramètres optionnels month et year, c'est l'année en cours qui sera affichée.

Exemples

Pour afficher les horaires des évènements solaires du mois d'octobre 2022 à Paris :

https://sunset.pays-guide.com?id=64780&month=10&year=2022

Pour afficher le calendrier complet des évènements solaires de 2022 à Paris :

https://sunset.pays-guide.com?id=64780&year=2022

Pour afficher les horaires des évènements solaires du mois en cours à Paris :

https://sunset.pays-guide.com?id=64780&month=current

Comment connaitre l'identifiant d'un lieu ?

Rien de plus simple ! Il suffit de rechercher la ville souhaitée dans notre base de données de 216 936 localités répertoriées dans le monde. Saisir le nom de la localité (ou son code postal pour la France) :

ID :

API - En cours de développement

Clé d'accès à l'API et authentification

Chaque compte utilisateur est associé à une clé d'accès unique à l'API, qui est utilisée pour s'authentifier auprès de notre service lors d'une requête. Pour obtenir votre clé d'accès personnelle à l'API, vous devez créer un compte.

Pour commencer à faire des requêtes sur l'API, veuillez vous authentifier conformément à l'exemple ci-dessous.

https://api-sunset.pays-guide.com?key=VOTRE_CLE

Paramètres

Paramètres Requis Description
key X Votre clé privée. Assurez-vous de garder votre clé privée en sécurité. Si vous pensez que votre clé d'accès à l'API est utilisée par une partie non autorisée, vous pouvez en générer une nouvelle à l'aide du tableau de bord de votre compte.
id Identifiant de la localité dans notre base de données. Voir « Comment connaitre l'identifiant d'un lieu ? »
coord Coordonnées latitude et longitude exprimées en décimale.

Exemples

https://api-sunset.pays-guide.com?key=VOTRE_CLE&cood=48.859,2.343

En cours de rédaction...