The StruxureWare Data Center Expert web services API is vendor-neutral, scalable monitoring software that collects, organizes, and distributes critical alerts, surveillance video, and key information. It provides a unified view of complex physical infrastructure environments from anywhere on the network.

Manage your APC devices from a single system by forwarding SNMP traps (events) to your preferred enterprise management system.

Device Access, Authentication and Permissions

StruxureWare Data Center Expert web services supports basic authentication over HTTP or HTTPS (SSL).

User credentials (username/password) must be provided for every web service method invocation; the concept of a single-login-session is not supported. The credentials used must belong to a valid StruxureWare Data Center Expert user account configured on the StruxureWare Data Center Expert server being queried.

The permissions configured on the StruxureWare Data Center Expert server for the user account can affect the contents of web service query responses. Responses to web service queries will only contain references to devices and other entities that the user account has been granted permission to access.

Localization and Internationalization

Most of the methods specified in the StruxureWare Data Center Expert web service interface accept a locale parameter which may affect the representation of data returned by those methods. In all instances, a locale is specified as a string in the format “xx-YY” where xx represents a two letter language identifier (in compliance with ISO-639 language codes) and YY represents a two letter country identifier (in compliance with ISO-3166 country codes).

Note: If no locale (null) or an unsupported locale is specified in a method call, the current server locale configuration is assumed.

If a specified locale has a language code that matches the language code of a supported locale, even though the country codes may not match, the supported locale will be used.

Supported locales in StruxureWare Data Center Expert
• US English (en-US)
• Japanese (ja-JP)
• Korean (ko-KR)
• Simplified Chinese (zh-CN)
• Russian (ru-RU)
• Brazilian Portuguese (pt-BR)
• French (fr-FR)
• Spanish (es-ES)
• Italian (it-IT)
• German (de-DE)

Web Service Description Language Files

Web services often employ one or more Web Service Description Language (WSDL) files to describe, in a standardized format, the methods of a web service interface and the data passed to and from those methods.

WSDL files can be used by client application developers to generate “stub” code for invoking the methods of a particular web service. There are a large number of publicly available WSDL-to-code generators. WSDL files can also be used at run-time to format data sent to, or validate received from, a web service method.

StruxureWare Data Center Expert server provides access to separate WSDL files.

ISXCentralAlarmsService_v2_0
ISXCentralDeviceGroupService_v2_0
ISXCentralDeviceService_v2_0
ISXCentralSensorService_v2_0

The StruxureWare Data Center Expert server publishes WSDL files at this URL:

http://<server>/integration/services/<WSDL>?wsdl

This URL returns dynamically generated WSDL files, guaranteeing the files reflect the version of the StruxureWare Data Center Expert software currently installed on the server. Access to this URL requires authentication credentials of a valid StruxureWare Data Center Expert user. Note the “?” in the URL.

Note: The dynamically generated WSDL contains references to the server from which it was obtained. In the static WSDL, server references are replaced with the string “SERVER_REPLACE_ME”. 

 


 

Skip to end of metadata
Go to start of metadata
  • No labels

1 Comment

  1. I believe the first two phrases on the page are not absolutely relevant to the subject - Web Services API

RELATED COMMUNITY QUESTIONS
WAS THIS ARTICLE HELPFUL?