Wiki

Case Status
Log In

Wiki

 
List of API Calls»API Call - Update List (Multip…
  • RSS Feed

Last modified on 8/12/2016 2:45 PM by User.

Tags:

API Call - Update List (Multiple Ports)

Description:

This call is designed to list updates for multiple ports and their associated objects, since a given version number.

Parameters:
 
format json, xml
port_id<n> The port's unique ID, where <n> is the index of the port you are requesting
vers<n> The base version from which to report subsequent updates, where <n> is the index of the port you are requesting

Call Format:

For all updates within a list of ports: /api/ports/update_list.<format>?port_id<n>=<port_id>&vers<n>=<base_version>

Example 1:

Input: http://www.findaport.com/api/ports/update_list.json?port_id0=100&vers0=1231
Output: An XML object showing the versions of the port information and its constituent parts (summary, sections, plans/photos, ACE reports)

Example 2:

Input: http://www.findaport.com/api/country/gb/updates.xml?version=12456
Output: An XML object showing the highest version level of the port and its constituent parts (summary, sections, plans/photos, ACE reports)

Output Fields:

Port version information

Output Fields Descriptions Examples
resource resource description port or country
resource_id ID of the resource, e.g. Port number 20 or GB
from_version Version number from which to report updates 11000
version Version number of update 56534
type Type of port data updated record
part Object updated port_facility
part_id ID of part updated drydock1
operation Add, delete, or update add

Output example:

Example Output - <port_id>.xml

 

Previous API Call: Submissions - Errata                            Next API Call: Port - Version               Return to API Call Summary


Need an API Key? Click here here for more details.

 

If you would like to find out more about Findaport.com or our Findaport API service, please contact us at info@portinfo.co.uk. Shipping Guides Ltd are recognised industry specialists in publishing port and harbour information for your various port entry requirements. For more information on our products, please visit www.portinfo.co.uk.

For port version information: /api/port/<port_id>/updates.<format>?version=<client_version>
For country version information: /api/country/<locode>/updates.<format>?version=<client_version>For port version information: /api/port/<port_id>/updates.<format>?version=<client_version>
For country version information: /api/country/<locode>/updates.<format>?version=<client_version>