| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Note: The API requires separate licensing.
The API is a standard set of web services, implemented as a set of RESTful interfaces, that allow external systems to retrieve information and submit Veslink form XML. The available endpoints and the actions available are documented at https://api.veslink.com/Help.
The methods available via the API are mainly GET and POST (with a PATCH method available to act on IMOS Dataforms).
The API supports form XML for all standard Veslink forms.
Enabling User-level Access to the API
...
An API Token, which is generated for a Veslink user account
An IP Allowlist entry , specifying allowed networks or machines for API access
...
You must request a unique API token to authenticate with all API calls. The API Token is passed in all of the query strings for each call , and is valid until you clear it.
Hover over the Profile menu and click My Profile.
In the Veslink API section, click the Request New API Token link.
Your API Token appears, along with the date and time it was generated:
To request a new API Token at any time, click the Request New API Token link.
To deactivate your API Token, click the Clear API Token link.
...
Units of Measure
Veslink Vessels: Vessels activated by a Client for use with Veslink
Ports: Port information from the proprietary Veslink distance tables
Companies: Companies you are partnered with
Suppliers
Cargoes: Commodity details (not cargo buy/sell contracts) specific to a Client database
Agents: Get authorized port calls and submit forms
Fuel Types: Fuel types and consumption categories
Financials: Currency and ledger codes
Delay Types
Port Activities: Descriptions of activities in port , specific to a Client database
Using these relevant master data, you can create form XML using the Standard Form XSDs and submit forms to Veslink.
API Monitoring and Security
Veson Nautical has added monitoring and security enhancements to the API, namely:
...
Programmatic access to the API logs for a given account, for the purposes of monitoring compliance, uncovering misuse, and gathering data for analytics (expected release in February 2020; subject to change without notice).
...
API Planned Enhancements
Note: Future enhancements are subject to change without notice.
Plans for enhancements for the API include role-based security, user-level access controls, and an API gateway to enhance API security, monitoring, and performance management.
Here is the current prioritized list for those enhancements:
...
API role-based security
...
API user-level access controls
...
.
...
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
...