L'API REST de Plugchoice te permet de construire ton propre produit sur la plateforme : lire les bornes, les sessions et les relevés de compteur, démarrer et arrêter la charge, gérer les cartes, les sites et le power management, 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 plus des guides sur l'authentification, les erreurs, la pagination et le rate limiting.
Tu construis avec un assistant IA ? Donne-lui developer.plugchoice.com/llms.txt (l'index) ou llms-full.txt (toute la documentation en un seul fichier). Ton outil de codage IA peut alors répondre aux questions sur l'API et écrire l'intégration pour toi.
Deux façons de s'authentifier
Personal access token : le démarrage le plus rapide. Crée-en un sous Settings > Personal Access Tokens dans le dashboard Plugchoice et tu peux appeler l'API sur ton propre compte immédiatement. Idéal pour les scripts, les tests et l'outillage interne.
OAuth 2.0 : pour les produits utilisés par tes clients. Ton application obtient son propre accès aux données de chaque client, avec sa permission, sans que personne ne partage de mots de passe ou de tokens.
À quoi ressemble OAuth pour ton client
Dans ton app, le client clique sur quelque chose comme Connecter Plugchoice.
Il arrive sur l'écran de connexion Plugchoice qu'il connaît et se connecte avec son propre compte.
Plugchoice lui demande d'approuver l'accès demandé par ton app, un clic.
Il revient directement dans ton app, qui reçoit alors en toute sécurité ses propres tokens pour ce client.
Pas de copie manuelle de tokens, pas de mots de passe partagés, et le client peut retirer l'accès à tout moment. C'est le même parcours que les clients connaissent déjà pour connecter d'autres services.
Obtenir l'accès
Pour activer OAuth pour ton application, nous n'avons besoin que d'une seule chose : ton redirect URL (l'adresse de ton app vers laquelle le client revient après approbation). Envoie-la via le messenger ou ton contact partenaire, et nous configurons ton client OAuth et t'envoyons les identifiants.
Les personal access tokens ne demandent rien de notre côté : crée-en un dans le dashboard et commence à construire.