Difference between revisions of "NEAFC2ICES WS"

Revision as of 14:51, 18 June 2014

Purposes

This wiki page details the API and the expected behavior of the NEAFC 2 ICES data exchange web service. Currently, the WS is hosted by FAO and provides access to a limited set of data (not intended for public use). In the future, this same WS will be made available by NEAFC and additional access constraints will apply.

Background

Please refer to this ticket for background about the purposes and rationale of this WS

Remarks

Unless a specific timeframe is explicitly requested, the extracted data will always reference information belonging to the past semester. This means that in such circumstances:

• Incoming requests sent from January 1st to June 30th will produce data related to the time period spanning from July 1st to December 31st of the previous year
• Incoming requests sent from July 1st to December 31st will produce data related to the time period spanning from January 1st to June 30th of the same year

API

Endpoint

The test WS endpoint is actually http://figisapps.fao.org/vrmf/neafc2ices with specific services detailed in the following paragraphs. The data export specific services may be invoked with the following URL:

http://figisapps.fao.org/vrmf/neafc2ices/services/exchange/export/{data}(/current%7C?{params})

where {data} is one among:

• vessels
• authorization
• positions
• catch
• all

Retrieve vessel data

This service extracts all the vessel data currently available, regardless of a time frame. The produced data

URL example

RID LENGTH_CATEGORY POWER_CATEGORY VESSEL_TYPE FISHING_GEAR