GE Energy WattStation™ Connect Web Services Guide
WattStation™ Connect Web Services Guide Contents WattStation™ Connect Web Services .......................................................................................... 3 Overview of WattStation Connect Web Services..........................................................................................3 Setting up user credentials for Web Services .................................................................................................3 Accessing Web Services ................................
WattStation™ Connect Web Services Guide WattStation™ Connect Web Sevices Overview of WattStation Connect Web Services WattStation Connect provides web services that allow third-party software applications to programmatically access data and functionality within WattStation network. These web services are defined by WSDL and accessed via SOAP over HTTPS.
WattStation™ Connect Web Services Guide Overview of GetStationDetails Web Service The GetStationDetails web service allows your application to request information about a specific charging station you own. To call this service, you must provide the owner‟s authentication credentials. The web service returns information about the charging station with the given serial number.
WattStation™ Connect Web Services Guide timeZone string The time zone in which the charging station is located. Values are derived from standard timeZone values obtained from the Java API call java.util.TimeZone.getAvailableIDs().
WattStation™ Connect Web Services Guide Online Offline Unknown If set to „offline,‟ all communication between the charging station and the WattStation Connect servers is disabled. accessType string Indicates if this station is publicly available, available for restricted or private use only, or if the station is not yet provisioned for use.
WattStation™ Connect Web Services Guide Overview of GetPublicStations Web Service The GetPublicStations web service allows your application to locate all charging stations that are publicly available within a specified geographical range. Use this API to locate public charging stations within latitude and longitude parameters specified.
WattStation™ Connect Web Services Guide GetPublicStationsResponse The following response is generated according to the request parameters you set up: Table 4: GetPublicStations Response Elements and Description Element Type Description stationSerialNumber string Serial number of the charging stations. longitude string The longitude coordinates of the WattStation‟s physical location. latitude string The latitude coordinates of the WattStation‟s physical location.
WattStation™ Connect Web Services Guide Asia/Sakhalin Asia/Anadyr Pacific/Auckland Pacific/Enderbury Pacific/Kiritimati chargeLevel string By default, Level 2 charging is selected. WattStations support Level 2 charging which provides faster charging with service needs of 208-240VAC at 40A. status string Indicates the status of your WattStation. For example, it indicates if a vehicle is connected or if the WattStation is idle.
WattStation™ Connect Web Services Guide Overview of GetOwnerStations Web Service Use the GetOwnerStations Web service to get a summary of all charging stations that you own. GetOwnerStationsRequest Table 5: GetOwnerStations Request Elements and Description Element Type Description username string The user name you established when creating your WattStation Connect user account. password string The password for your WattStation Connect user account.
WattStation™ Connect Web Services Guide timeZone string The time zone in which the charging station is located. Values are derived from standard timeZone values obtained from the Java API call java.util.TimeZone.getAvailableIDs().
WattStation™ Connect Web Services Guide • • • 12 GE Energy otherwise reported as "Unavailable") Unavailable Unknown Not Communicating ©2012 GE Company All Rights Reserved
WattStation™ Connect Web Services Guide Overview of GetOwnerStationsDetailed Web Service Use the GetOwnerStationsDetailed Web service to get detailed information for all charging stations owned by a specific owner. GetOwnerStationsDetailedRequest Table 5: GetOwnerStationsDetailed Request Elements and Description Element Type Description username string The user name you established when creating your WattStation Connect user account.
WattStation™ Connect Web Services Guide WattStation is located. timeZone string The time zone in which the charging station is located. Values are derived from standard timeZone values obtained from the Java API call java.util.TimeZone.getAvailableIDs().
WattStation™ Connect Web Services Guide charging station and the WattStation Connect servers is disabled. accessType string Indicates if this station is publicly available, available for restricted or private use only, or if the station is not yet provisioned for use. The access to your WattStation can be set to one of the following options: Public Private Not Provisioned status string Indicates the status of your WattStation.
WattStation™ Connect Web Services Guide Authentication and Error Handling If an error occurs during the processing of a service, a generic exception of type EVSEWebServiceException is thrown. The EVSEWebServiceException exception represents all exceptions that can occur during a web service call. To understand why the exception was thrown, you must look at attributes within the EVSEWebServiceException.
WattStation™ Connect Web Services Guide Example of a fault element Given below is an example of the element for Bad Login Credentials: The element is the „message‟ attribute of the EVSEWebServiceException. In this case, it gives a message „Bad Login Credentials.‟ The element provides the „errorCode‟ for the EVSEError object of the EVSEWebServiceException. In this example, the error code is 100.
GE Energy 41 Woodford Ave. Plainville, CT 06062 www.geindustrial.com © 2012 GE Energy, Inc. All rights reserved. WattStation™ is a trademark of General Electric Company. All other trademarks are the property of their respective owners. Confidential Information - This document contains Confidential/Proprietary Information of GE Energy and/or its suppliers or vendors. Distribution or reproduction prohibited without permission.