L'API REST de Plugchoice vous permet de construire votre propre produit sur la plateforme : lire les bornes de recharge, les sessions et les relevés de compteur, démarrer et arrêter la charge, gérer les cartes, les sites et la gestion de l'énergie, et plus encore. Cette page est la version courte pour les partenaires ; la documentation technique complète se trouve sur developer.plugchoice.com.
Où se trouve la documentation
developer.plugchoice.com : la référence API complète et des guides sur l'authentification, les erreurs, la pagination et les limites de débit.
Vous travaillez avec un assistant IA ? Donnez-lui developer.plugchoice.com/llms.txt (l'index) ou llms-full.txt (toute la documentation en un seul fichier). Votre outil de codage IA peut alors répondre aux questions sur l'API et écrire l'intégration pour vous.
Deux façons de s'authentifier
Personal access token : le démarrage le plus rapide, pour votre propre usage de votre propre compte, comme des scripts, des tests, la domotique ou votre propre tableau de bord. Créez-en un dans le portail web sous Paramètres > Votre compte > Jetons d’API avec Créer un jeton d’API. Utiliser un jeton dans un produit ou un service pour d'autres, ou pour accéder aux données d'autres comptes, nécessite API Professional.
OAuth 2.0 (API Professional) : pour les produits utilisés par vos clients. Votre application obtient son propre accès aux données de chaque client, avec son autorisation et dans les scopes qu'il approuve, sans que personne ne partage de mots de passe ou de jetons. API Professional fait l'objet d'un accord séparé sur les scopes, les limites de débit et les tarifs.
À quoi ressemble OAuth pour votre client
Dans votre app, le client clique sur un bouton comme Connecter Plugchoice.
Il arrive sur l'écran de connexion Plugchoice et se connecte avec son propre compte, aussi avec Google ou Apple.
Plugchoice affiche l'accès demandé par votre app, et le client l'approuve avec Autoriser.
Il revient dans votre app, qui reçoit alors ses propres jetons pour ce client.
Personne ne copie de jetons ni ne partage de mots de passe. Le client peut retirer l'accès à tout moment dans le portail web sous Paramètres > Votre compte > Applications connectées (Révoquer l’accès), et pour une seule borne sous Paramètres > Applications de cette borne.
Vos clients et leurs données
Votre app n'utilise les données d'un client que dans les scopes qu'il a approuvés et pour votre propre service à ce client.
Les transferts de propriété, les octrois d'accès et autres étapes de consentement ne sont jamais automatisés : l'utilisateur confirme chacun d'eux.
Toute personne qui obtient un compte Plugchoice via votre app, Link ou l'API est cliente de Plugchoice selon nos conditions, sauf si un accord signé vous attribue cette relation client. Nous pouvons informer ces clients nous-mêmes et leur présenter l'app Plugchoice.
Quand un client révoque l'accès ou supprime son compte, votre app cesse d'envoyer des commandes à ses bornes, supprime sans retard injustifié les données personnelles reçues via l'API et supprime les autres données de l'API dans les 30 jours.
Obtenir l'accès
OAuth fait partie d'API Professional. Envoyez-nous votre URL de redirection (l'adresse de votre app vers laquelle le client revient après avoir approuvé) via la messagerie ou votre contact partenaire. Une fois l'accord conclu, nous configurons votre client OAuth et vous envoyons les identifiants.
Les personal access tokens ne demandent aucune configuration de notre part : créez-en un dans le portail web et commencez à développer.