There are 3 steps required to get an API key
- Sign up to findaport.com
- Email us to request your account be upgraded to include access to the API
- Once we have upgraded your account, you can apply for an API Key
The API Key
The API Key is a string of 30 characters, and looks like "de42a32a48b80678837ba605b258f2"
It is used in the querystring in each API call and is a mandatory parameter:
Test your API key
Click this link to try to return some summary information about the port of Aabenraa in Denmark. It should try to open this link:
At first, the link will return no information. You need to add your API key to the end of the URL in the address bar to correctly form the API request. For example, if your API key is "0123456789abcdefg" then the address for the API call would be:
You should see output like this in your browser:
A failure to authenticate, usually because the key string is incorrect, will raise an error.
Other errors, all of which your code should detect and manage, are documented in Error Codes.
==> Next: Download sample applications
If you would like to find out more about Findaport.com or our Findaport API service, please contact us at firstname.lastname@example.org. 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.