▼
Scroll to page 2
of
18
GE Energy WattStation™ Connect Guide des services Internet 1 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Table des matières Services Internet WattStation™ Connect....................................................................................... 3 Aperçu des services Internet WattStation Connect ....................................................................................3 Établissement des éléments d'identification de l'utilisateur pour les services d’Internet .........3 Accès aux services Internet.....................................................................................................................................3 Aperçu des services Internet GetStationDetails ............................................................................................4 GetStationDetailsRequest .................................................................................................................................. 4 GetStationDetailsResponse............................................................................................................................... 4 Aperçu des services Internet GetPublicStations ...........................................................................................7 GetPublicStationsRequest ................................................................................................................................. 7 GetPublicStationsResponse .............................................................................................................................. 8 Aperçu des services Internet GetOwnerStations ....................................................................................... 10 GetOwnerStationsRequest .............................................................................................................................. 10 GetOwnerStationsResponse........................................................................................................................... 10 Aperçu des services Internet GetOwnerStationsDetailed ..................................................................... 13 GetOwnerStationsDetailedRequest ............................................................................................................ 13 GetOwnerStationsDetailedResponse ......................................................................................................... 13 Traitement de l'authentification et des erreurs .......................................................................................... 16 Exemple d'un élément de défaillance ........................................................................................................ 17 2 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Services Internet WattStation™ Connect Aperçu des services Internet WattStation Connect WattStation Connect procure des services Internet qui permettent aux applications logicielles de sociétés indépendantes d'accéder à des données et des fonctionnalités via des programmes sur le réseau WattStation. Ces services Internet sont définis par l'interface WSDL et accédés via le protocole SOAP sur le protocole HTTPS. WattStation Connect offre les services d’Internet suivants : GetStationDetails GetPublicStations GetOwnerStations GetOwnerStationsDetailed Toutes les requêtes à un service Internet WattStation Connect nécessitent des éléments d'identification d'authentification pour identifier le demandeur et les paramètres facultatifs spécifiques à la requête. Ces services Internet ne sont disponibles qu'aux propriétaires de postes WattStation ayant un rôle de gestion. Établissement des éléments d'identification de l'utilisateur pour les services d’Internet Veuillez suivre cette procédure pour configurer vos éléments d'identification et commencer à utiliser les servies Internet : 1. Aller à www.gewattstation.com 2. Cliquer sur S'inscrire pour créer un nouveau compte d'utilisateur WattStation Connect. Si vous possédez déjà un compte, ouvrez simplement une session avec votre nom d'utilisateur et votre mot de passe. Vous avez maintenant accès à tous les services offerts par WattStation Connect en acheminant vos éléments d'identification à chaque appel de service Internet. Accès aux services Internet Les fichiers EVSEwebservices.wsdl sont situés à : https://services.gewattstation.com/EVSEWebServices/services/EVSEWebServices?WSDL 3 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Aperçu des services Internet GetStationDetails Le service Internet GetStationDetails permet à votre application d'effectuer des requêtes de renseignements au sujet d'un de vos postes de recharge spécifique. Pour utiliser ce service, vous devez fournir les éléments d'identification d'authentification du propriétaire. Le service Internet vous envoie des renseignements au sujet du poste de recharge ayant le numéro de série fourni. GetStationDetailsRequest Tableau 1 : Éléments et description de GetStationDetailsRequest Élément Type Description username (nom d'utilisateur) chaîne Votre nom d'utilisateur WattStation Connect. password (Mot de passe) chaîne Votre mot de passe WattStation Connect. stationSerialNumber (Numéro de série du poste) chaîne Le numéro de série imprimé sur votre appareil WattStation. GetStationDetailsResponse Par défaut, les réponses incluent tous les champs de réponse disponibles à votre compte. Tableau 2 : Éléments et description de GetStationDetailsResponse Élément Type Description stationSerialNumber (Numéro de série du poste) chaîne Le numéro de série imprimé sur votre appareil WattStation. longitude chaîne Les coordonnées de longitude de l'emplacement physique de poste WattStation. latitude chaîne Les coordonnées de latitude de l'emplacement physique de poste WattStation. postalCode (Code postal) chaîne Le code postal de la région dans laquelle est situé le 4 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet poste WattStation. timeZone (Fuseau horaire) chaîne Le fuseau horaire où se situe le poste de recharge. Les valeurs sont dérivées à partir des valeurs timeZone standard obtenues de l'appel Java AP Ijava.util.TimeZone.getAvailableIDs(). Ces valeurs peuvent être (sans y être limitées) : ÉU/Samoa ÉU/Îles Aléoutiennes ÉU/Hawaii ÉU/Alaska ÉU/Pacifique ÉU/Arizona ÉU/Montagne ÉU/Centre ÉU/Est ÉU/Michigan Atlantique/Bermudes Amérique/Araguaina Amérique/Noronha Atlantique/Açores Europe/Belfast Europe/Dublin Europe/Amsterdam Europe/Andorre Europe/Athènes Europe/Bucarest Europe/Moscou Europe/Samara Asie/Bakou Asie/Aqtau Asie/Almaty Asie/Bangkok Asie/Brunei Asie/Dili Asie/Sakhaline Asie/Anadyr Pacifique/Auckland Pacifique/Enderbury Pacifique/Kiritimati displayName (Nom d'affichage) chaîne Le nom utilisé pour identifier ce poste de recharge. Le nom d'affichage peut être un nom commercial ou le numéro de série. maxCurrent (Intensité maximum) chaîne L'intensité électrique maximum permise à votre poste WattStation. Par exemple, 30 A. chargeLevel (Niveau de recharge) chaîne Le niveau 2 de recharge est sélectionné par défaut. Les postes WattStation acceptent la recharge de niveau 2 qui procure une recharge plus rapide avec une alimentation de 208 à 240 V CA à 40 A. 5 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet operationalMode (Mode opérationnel) chaîne Le mode opérationnel de votre poste WattStation peut être l'un des suivants : En ligne Hors ligne Inconnu Lorsque réglé à Hors ligne, toute communication entre le poste de recharge et les serveurs WattStation Connect est désactivée. accessType (Type d'accès) chaîne Indique si ce poste est disponible au public, disponible à une utilisation limitée ou privée ou si le poste n'est pas encore activé pour une utilisation. L'accès au poste WattStation peut être établi par l'une des options suivantes : Publique Privé Non activé status (État) chaîne Indique l'état de votre poste WattStation. Par exemple, il indique si un véhicule est connecté ou si le poste WattStation est en attente. Les valeurs d'état possibles incluent : • Disponible • Connecté • Recharge en cours • Défaillance (si vous êtes le propriétaire, sinon, il est signalé en tant que "Non disponible") • Non disponible • Inconnu • Pas de communication stationMake (Marque du poste) chaîne La valeur par défaut est "GE". stationModel (Modèle du poste) chaîne Le modèle par défaut est "poste WattStation sur socle". provisionedDate (Date d'activation) dateTime La date précise à laquelle le poste WattStation a été (date et activé à des fins d'utilisation. heure) WarrantyStartDate (Date du début dateTime La date à laquelle la garantie du fabricant du poste de de la garantie) (date et recharge débute. heure) warrantyLength (Durée de garantie) 6 chaîne GE Energy La durée de la garantie (en jours) depuis la date du début de la garantie du poste de recharge. ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Aperçu des services Internet GetPublicStations Le service Internet GetPublicStations permet à votre application de localiser tous les postes de recharge disponibles au public à l'intérieur d'une zone géographique spécifiée. Utilisez cet API pour localiser des postes de recharge publics ayant les paramètres de latitude et de longitude spécifiés. GetPublicStations présente une liste de postes qui correspondent à vos critères de recherche et vous procure des détails tels que l'adresse, la disponibilité et les coûts affichés au poste (si les données de prix sont disponibles). GetPublicStationsRequest Tableau 3 : Éléments et description de GetPublicStations Request Élément Type Description username (Nom d'utilisateur) chaîne Le nom de l'utilisateur que vous avez établi lors de la création de votre compte d'utilisateur WattStation Connect. password (Mot de passe) chaîne Le mot de passe associé à ce compte. minLongitude (Longitude minimum) double Les coordonnées de longitude minimum servant à définir la gamme de début d'une région pour laquelle vous désirez récupérer des renseignements relatifs à des postes de recharge publics. maxLongitude (Longitude maximum) double Les coordonnées de longitude maximum servant à définir la gamme de fin d'une région pour laquelle vous désirez récupérer des renseignements relatifs à des postes de recharge publics. minLatitude (Latitude minimum) double Les coordonnées de latitude minimum servant à définir la gamme de début d'une région pour laquelle vous désirez récupérer des renseignements relatifs à 7 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet des postes de recharge publics. maxLatitude (Latitude maximum) double Les coordonnées de latitude maximum servant à définir la gamme de fin d'une région pour laquelle vous désirez récupérer des renseignements relatifs à des postes de recharge publics. GetPublicStationsResponse Les réponses suivantes sont générées selon les paramètres de requête que vous avez établis : Tableau 4 : Éléments et description de GetPublicStations Response Élément Type Description stationSerialNumber (Numéro de série du poste) chaîne Le numéro de série des postes de recharge. longitude chaîne Les coordonnées de longitude de l'emplacement physique de poste WattStation. latitude chaîne Les coordonnées de latitude de l'emplacement physique de poste WattStation. address (Adresse) chaîne L'adresse de postes de recharge disponibles au public. postalCode (Code postal) chaîne Le code postal de la région dans laquelle est situé le poste de recharge. timeZone (Fuseau horaire) chaîne Le fuseau horaire où se situe le poste de recharge. Les valeurs sont dérivées à partir des valeurs timeZone standard obtenues de l'appel Java AP Ijava.util.TimeZone.getAvailableIDs(). Ces valeurs peuvent être (sans y être limitées) : ÉU/Samoa ÉU/Îles Aléoutiennes ÉU/Hawaii ÉU/Alaska ÉU/Pacifique ÉU/Arizona ÉU/Montagne ÉU/Centre ÉU/Est ÉU/Michigan Atlantique/Bermudes Amérique/Araguaina Amérique/Noronha Atlantique/Açores Europe/Belfast Europe/Dublin Europe/Amsterdam Europe/Andorre Europe/Athènes 8 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Europe/Bucarest Europe/Moscou Europe/Samara Asie/Bakou Asie/Aqtau Asie/Almaty Asie/Bangkok Asie/Brunei Asie/Dili Asie/Sakhaline Asie/Anadyr Pacifique/Auckland Pacifique/Enderbury Pacifique/Kiritimati chargeLevel (Niveau de recharge) chaîne Le niveau 2 de recharge est sélectionné par défaut. Les postes WattStation acceptent la recharge de niveau 2 qui procure une recharge plus rapide avec une alimentation de 208 à 240 V CA à 40 A. status (État) chaîne Indique l'état de votre poste WattStation. Par exemple, il indique si un véhicule est connecté ou si le poste WattStation est en attente. Les valeurs d'état possibles incluent : • Disponible • Connecté • Recharge en cours • Défaillance (si vous êtes le propriétaire, sinon, il est signalé en tant que "Non disponible") • Non disponible • Inconnu • Pas de communication 9 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Aperçu des services Internet GetOwnerStations Utilisez le service Internet GetOwnerStations pour obtenir un résumé de tous vos postes de recharge. GetOwnerStationsRequest Tableau 5 : Éléments et description de GetOwnerStations Request Élément Type Description username (Nom d'utilisateur) chaîne Le nom de l'utilisateur que vous avez établi lors de la création de votre compte d'utilisateur WattStation Connect. password (Mot de passe) chaîne Le mot de passe de votre compte d'utilisateur WattStation Connect. GetOwnerStationsResponse La réponse présentée inclut les renseignements suivants basés sur les éléments d'identification fournis avec la requête. Tableau 6 : Éléments et description de GetOwnerStations Response Élément Type Description stationSerialNumber (Numéro de série du poste) chaîne Le numéro de série imprimé sur votre appareil WattStation. longitude chaîne Les coordonnées de longitude de l'emplacement physique de poste WattStation. latitude chaîne Les coordonnées de latitude de l'emplacement physique de poste WattStation. address (Adresse) chaîne L'adresse de l'emplacement du poste de recharge. postalCode (Code postal) chaîne Le code postal de la région dans laquelle est situé le 10 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet poste WattStation. timeZone (Fuseau horaire) chaîne Le fuseau horaire où se situe le poste de recharge. Les valeurs sont dérivées à partir des valeurs timeZone standard obtenues de l'appel Java AP Ijava.util.TimeZone.getAvailableIDs() . Ces valeurs peuvent être (sans y être limitées) : ÉU/Samoa ÉU/Îles Aléoutiennes ÉU/Hawaii ÉU/Alaska ÉU/Pacifique ÉU/Arizona ÉU/Montagne ÉU/Centre ÉU/Est ÉU/Michigan Atlantique/Bermudes Amérique/Araguaina Amérique/Noronha Atlantique/Açores Europe/Belfast Europe/Dublin Europe/Amsterdam Europe/Andorre Europe/Athènes Europe/Bucarest Europe/Moscou Europe/Samara Asie/Bakou Asie/Aqtau Asie/Almaty Asie/Bangkok Asie/Brunei Asie/Dili Asie/Sakhaline Asie/Anadyr Pacifique/Auckland Pacifique/Enderbury Pacifique/Kiritimati chargeLevel (Niveau de recharge) chaîne Le niveau 2 de recharge est sélectionné par défaut. Les postes WattStation acceptent la recharge de niveau 2 qui procure une recharge plus rapide avec une alimentation de 208 à 240 V CA à 40 A. status (État) chaîne Indique l'état de votre poste WattStation. Par exemple, il indique si un véhicule est connecté ou si le poste WattStation est en attente. Les valeurs d'état possibles incluent : • Disponible 11 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet • • • • • • 12 GE Energy Connecté Recharge en cours Défaillance (si vous êtes le propriétaire, sinon, il est signalé en tant que "Non disponible") Non disponible Inconnu Pas de communication ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Aperçu des services Internet GetOwnerStationsDetailed Utilisez le service Internet GetOwnerStationsDetailed pour obtenir des renseignements détaillés sur tous les postes de recharge appartenant à un propriétaire spécifique. GetOwnerStationsDetailedRequest Tableau 5 : Éléments et description de GetOwnerStationsDetailed Request Élément Type Description username (Nom d'utilisateur) chaîne Le nom de l'utilisateur que vous avez établi lors de la création de votre compte d'utilisateur WattStation Connect. password (Mot de passe) chaîne Le mot de passe de votre compte d'utilisateur WattStation Connect. GetOwnerStationsDetailedResponse Par défaut, la réponse présentée inclut les renseignements suivants basés sur les éléments d'identification fournis. Tableau 6 : Éléments et description de GetOwnerStationsDetailed Response Élément Type Description stationSerialNumber (Numéro de série du poste) chaîne Le numéro de série imprimé sur votre appareil WattStation. longitude chaîne Les coordonnées de longitude de l'emplacement physique de poste WattStation. latitude chaîne Les coordonnées de latitude de l'emplacement physique de poste WattStation. address (Adresse) chaîne L'adresse de postes de charge disponibles au public. postalCode (Code postal) chaîne Le code postal de la région dans laquelle est situé le 13 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet poste WattStation. timeZone (Fuseau horaire) chaîne Le fuseau horaire où se situe le poste de recharge. Les valeurs sont dérivées à partir des valeurs timeZone standard obtenues de l'appel Java AP Ijava.util.TimeZone.getAvailableIDs() . Ces valeurs peuvent être (sans y être limitées) : ÉU/Samoa ÉU/Îles Aléoutiennes ÉU/Hawaii ÉU/Alaska ÉU/Pacifique ÉU/Arizona ÉU/Montagne ÉU/Centre ÉU/Est ÉU/Michigan Atlantique/Bermudes Amérique/Araguaina Amérique/Noronha Atlantique/Açores Europe/Belfast Europe/Dublin Europe/Amsterdam Europe/Andorre Europe/Athènes Europe/Bucarest Europe/Moscou Europe/Samara Asie/Bakou Asie/Aqtau Asie/Almaty Asie/Bangkok Asie/Brunei Asie/Dili Asie/Sakhaline Asie/Anadyr Pacifique/Auckland Pacifique/Enderbury Pacifique/Kiritimati displayName (Nom d'affichage) chaîne Le nom utilisé pour identifier ce poste de recharge. Le nom d'affichage peut être un nom commercial ou le numéro de série. maxCurrent (Intensité maximum) chaîne L'intensité électrique maximum permise à votre poste WattStation. Par exemple, 30 A. chargeLevel (Niveau de recharge) chaîne Le niveau 2 de recharge est sélectionné par défaut. Les postes WattStation acceptent la recharge de niveau 2 qui procure une recharge plus rapide avec une alimentation de 208 à 240 V CA à 40 A. operationalMode (Mode opérationnel) chaîne Le mode opérationnel de votre poste WattStation peut être l'un des suivants : En ligne Hors ligne Inconnu 14 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Lorsque réglé à Hors ligne, toute communication entre le poste de recharge et les serveurs WattStation Connect est désactivée. accessType (Type d'accès) chaîne Indique si ce poste est disponible au public, disponible à une utilisation limitée ou privée ou si le poste n'est pas encore activé pour une utilisation. L'accès au poste WattStation peut être établi par l'une des options suivantes : Publique Privé Non activé status (État) chaîne Indique l'état de votre poste WattStation. Par exemple, il indique si un véhicule est connecté ou si le poste WattStation est en attente. Les valeurs d'état possibles incluent : • Disponible • Connecté • Recharge en cours • Défaillance (si vous êtes le propriétaire, sinon, il est signalé en tant que "Non disponible") • Non disponible • Inconnu • Pas de communication stationMake (Marque du poste) chaîne La valeur par défaut est GE. stationModel (Modèle du poste) chaîne Le modèle par défaut est "poste WattStation sur socle". provisionedDate (Date d'activation) dateTime La date précise à laquelle le poste WattStation a été (date et activé à des fins d'utilisation. heure) WarrantyStartDate (Date du début dateTime La date à laquelle la garantie du fabricant du poste de la garantie) (date et de recharge débute. heure) warrantyLength (Durée de garantie) 15 chaîne GE Energy La durée de la garantie (en jours) depuis la date du début de la garantie du poste de recharge. ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Traitement de l'authentification et des erreurs Si une erreur se produit au cours du service, une exception générique du type EVSEWebServiceException (Exception de service Internet ESVE) est déclenchée. L'exception EVSEWebServiceException représente toutes les exceptions qui peuvent survenir pendant un appel de service Internet. Pour comprendre la raison pour laquelle l'exception a été déclenchée, vous devez examiner les attributs dans EVSEWebServiceException. Le message d'attribut et le code d'erreur « EVSEError » donnent les renseignements pertinents au sujet de la cause de l’exception. Le "message" d'attribut est la description de la chaîne de l'exception. L'attribut "errorCode" (Code d'erreur) de l'objet "EVSEError" (Erreur EVSE) est la valeur intégrale unique représentant la raison de cette exception. Voici des types d'erreurs pouvant se produire au cours du service, ainsi que le message d'erreur et les valeurs de code d'erreur. Tableau 7 : Codes d'erreur et messages d'erreur correspondants Code Message d'erreur Description 100 Invalid username or password (Nom Mauvaise entrée d'ouverture de session d'utilisateur et mot de passe non valide) 101 Insufficient privileges to perform L'utilisateur n'a pas les autorisations requises this operation (Privilèges insuffisants pour accéder à ce service Internet. pour effectuer cette opération) 103 Service Exception (Exception de service) 104 Station not found (Poste non trouvé) Le numéro de série du poste n'a pas été trouvé. 105 Invalid parameter (Paramètre non valide) Une exception générale est déclenchée lorsque le service de l'ordinateur principal ne peut effectuer l'opération en raison d'une erreur interne. Un paramètre acheminé au service est non valide. Si votre client ne prend pas en charge les exceptions, les exceptions sont alors retournées au client en tant que réponse d'enveloppe SOAP. Dans l'enveloppe SOAP, on retrouvera un élément <soap:fault>. L'élément <soap:fault> contiendra la raison de l'exception et le code d'erreur. 16 GE Energy ©2012 GE Company Tous droits réservés WattStation™ Connect Guide des services Internet Exemple d'un élément de défaillance Voici un exemple d'un élément <soap:fault> pour une mauvaise entrée d'ouverture de session : L'élément <faultstring> est l'attribut de "message" de EVSEWebServiceException (Exception de service Internet ESVE). Dans ce cas, il donne un message "Bad Login Credentials" (Mauvaise entrée d'ouverture de session). L'élément <errorCode> procure le "errorCode" de l'objet EVSEError de EVSEWebServiceException (Exception de service Internet ESVE). Dans cet exemple, le code d'erreur est 100. Se référer à la section 7 pour obtenir la description des messages d’erreur et des codes d'erreur correspondants. REMARQUE : Les services d’Internet WattStation Connect RESTful seront disponibles en septembre 2012. 17 GE Energy ©2012 GE Company Tous droits réservés GE Energy 41 Woodford Ave. Plainville, CT 06062 www.geindustrial.com © 2012 GE Energy, Inc. Tous droits réservés. WattStation™est une marque de commerce de General Electric Company. Toutes les autres marques de commerce sont la propriété de leurs détenteurs respectifs. Renseignements confidentiels - Ce document renferme des renseignements confidentiels/exclusifs à GE Energy et(ou) ses fournisseurs ou ses vendeurs. Toute distribution ou reproduction est interdite sans avoir reçu une autorisation. CE DOCUMENT ET SON CONTENU SONT FOURNIS "TELS QUELS", SANS REPRÉSENTATIONS OU GARANTIES DE TOUTE SORTE, QU'ELLES SOIENT EXPRESSES OU IMPLICITES, Y COMPRIS MAIS SANS S'Y LIMITER, LES GARANTIES DE CONCEPTION, DE QUALITÉ MARCHANDE OU D'APTITUDE À UNE UTILISATION PARTICULIÈRE. TOUTE AUTRE RESPONSABILITÉ DÉCOULANT DE LA FIABILITÉ DES RENSEIGNEMENTS CONTENU DANS LA PRÉSENTE EST EXPRESSÉMENT DÉCLINÉE. DET-772-FR (6/12)