C’est quoi une API ?

API : Application Programming Interface
Ne laissez pas l’acronyme vous faire peur ! API signifie :

• Application Programming Interface

Le mot le plus important est “interface”, et c’est le mot le plus simple, car nous utilisons tous des interfaces au quotidien.

Une API est une interface pour les applications, car un logiciel n’a pas de mains ni d’yeux pour interagir avec les interfaces physiques !

Une API permet de connecter deux applications comme des pièces de puzzle !

Pourquoi utiliser une API ?

• Pour l’envoi de mails par SPIP

Une fonctionnalité nécessaire et souvent importante, pour les inscriptions, la notification de commentaires, l’animation éditoriale, la gestion des formulaires d’interaction, voire pour des fonctions de paiement en ligne, de don, d’adhésion, etc.

Lorsque l’envoi des mails se fait par le serveur qui héberge le site, il n’est pas rare que ceux-ci soient signalés comme SPAM à la réception.

Pour éviter cela, il faut utiliser un service externe. C’est encore plus indispensable si vous voulez faire de l’envoi en masse de type Newsletter.

Il y a principalement 2 solutions :

– utiliser un serveur SMTP, qui peut être fourni par votre fournisseur de nom de domaine ou votre hébergeur. C’est une solution simple, mais attention à bien regarder les limites d’un tel service, il y a parfois un nombre maximum d’e-mails envoyés par jour ou par heure, pour éviter l’utilisation par des Spammeurs. Cela peut être limitant pour l’envoi de Newsletters, mais très suffisant pour les autres e-mails

– utiliser un service commercial externe spécialisé dans l’envoi des e-mails transactionnels ou de publipostage, dont certains proposent une offre gratuite d’entrée de gamme

• Pour la Météo avec le plugin Rainette

permettre d’afficher les conditions et les prévisions météorologiques d’un lieu donné à partir d’un web-service météorologique.

La plateforme SpipFactory s’appuie sur Weatherbit.io, toutefois il vous faudra persévérer car difficile de trouver la ville que l’on souhaite

Exemple :
« Saint-Étienne, France » renvoie vers Saint-Étienne-sur-Chalaronne dans l’Ain au lieu de la patrie des verts dans la Loire !

Il fallait indiquer « St Étienne »

Les clés API fournie par SpipFactory

<contenu_adherent|>

Pour Mailjet

• https://fr.mailjet.com/
  – clé API : 2268cd7386d8352c7148a3496438113d
  – Pass : baf8bf0b4f1bf12c811e54135e98986e
• « Serveur SMTP : in-v3.mailjet.comrveur SMTP : in-v3.mailjet.com
• Utiliser TLS : optionnel
• Port : 25 ou 587 (certains hébergeurs bloquent le port 25)
  Si TLS ne fonctionne pas sur le port 587, essayez avec le port 465 et/ou utilisez plutôt SSL »

pour la météo via Weatherbit.io

– clé API : 203f7b36bdbf48c1b9b638170a7ae03a