...
The primary purpose of this service is to identify which Data Products and Formats (file extensions) are available for the Locations, Devices, Device Categories or Properties of interest. Use the dataProductCode and extension when requesting a data product via the dataProductDelivery web service.
For a list of available data product codes and extensions, along with help document links, see the Available Data Products page.
See External Web Services for method and token usage and error messages.
URL
No Format |
---|
https://data.oceannetworks.ca/api/dataProducts |
...
Parameter | Type | Description | Example |
---|---|---|---|
Required | |||
token | string | ll Web Services require a token. Once logged in at https://data.oceannetworks.ca/login, your token can be retrieved or generated at https://data.oceannetworks.ca/Profile . Click on the "Web Services" tab, then click "Generate Token". | token=5ba514e8-1203-428c-8835-879c8173e387YOUR_TOKEN_HERE |
Optional | |||
dataProductCode | string | Return all Data Product Extensions matching a specific Data Product Code.
| dataProductCode=annotationfile |
extension | string | Return all Data Products that have a specific File Extension.
| extension=csv |
dataProductName | string | Return all Data Products where the Data Product Name contains a keyword.
| dataProductName=time |
locationCode | string | Return all Data Products available for a specific Location.
| locationCode=BACAX |
deviceCategoryCode | string | Return all Data Products available for devices belonging to a specific Device Category.
| deviceCategoryCode=ADCP2MHZ |
deviceCode | string | Return all Data Products available for a specific Device.
| deviceCode=AandOpt0581 |
propertyCode | string | Return all Data Products available for a specific Property.
| propertyCode=airdensity |
...
Property | Type | Description | Example |
---|---|---|---|
dataProductCode | string | Returns the data product code. | "dataProductCode":"TSSD" |
dataProductName | string | Returns the name of the data product. | "dataProductName":"Time Series Scalar Data" |
extension | string | Returns the file extension for the data product. | "extension":"json" |
hasDeviceData | boolean | Returns whether at least one device and/or sensor with this data product is NEPTUNE searchable | "hasDeviceData":true |
hasPropertyData | boolean | Returns whether at least one sensor with this data product is a NEPTUNE-searchable primary sensor | "hasPropertyData":false |
helpDocument | string | Returns a Link URL to the Oceans 2.0 Help documentation for the specific Data Product. | "helpDocument":"https://wiki.oceannetworks.ca/display/DP/1" |
...
errorCode | errorMessage | Description |
---|---|---|
127 | Invalid parameter value | Occurs when an invalid code is used in the filter. Most filters require an exact match, otherwise this error will occur.
|
129 | Invalid parameter name | Occurs when an unsupported a filter parameter is in the query but is not supported.
|
URL Examples
- Return a list of All Data Product Extensions (no filters)
...