New Fishhealth APIs
VesselTrackWeek apis replace the WellBoatWeek apis. VesselTrackWeek tracks all wellboats as before, but also other vessels that have been at an aquaculture site.
Endpoints:
The WellBoatWeek API is marked as obsolete, and will be removed after 4. May 2021.
New Waveforecast APIs
Get wind forecast along a fairway:
To access the BarentsWatch API it is mandatory to register and use a token, as documented here:
Application registration and authentication
.
Today this policy is enforced, and unauthenticated requests will recieve a 401 HTTP status code. If you get this error, you need to self-register a client, and pass an access token with your requests.
Due to a new data source for ISA and PD diseases, there will be changes in this endpoint:
/v1/geodata/fishhealth/locality/{localityId:int}/{year:int}/{week:int}
The "ilaPd" property will be null for all localities from week 45, 2020. The new property "ilaPdCase" will have the information about diseases.
This endpoint has a new data model:
"ilaPdCase": [
{
"id": "PD2020-67",
"localityNo": 20815,
"disease": "PD",
"subtype": "SAV3",
"disproved": false,
"suspectedDate": "2020-05-05T02:00:00+02:00",
"confirmedDate": null,
"emptiedDate": null,
"closedDate": null,
"disprovedDate": null,
"createdDate": null,
"changedDate": "2020-05-05T02:00:00+02:00"
}
]
The change of the API will take effect 7
th
January 2021. The API documentation will also be updated this date. If you need documentation earlier, please contact us.
As previously announced, the old apis at /api have been removed today. Use /bwapi as described here: The old API will be removed 1st October 2020.
The exception is chart plotter APIs, which are still open.
The ports API is also removed, as announced here: The Ports API will be removed 1st October 2020
.
New endpoints Fishhealth:
V2 version of these endpoints with epsg:4326 coodinate system.
Corresponding V1-endpoints are deprecated, and will be removed after 1. january 2021.
New endpoint FiskInfo:
Modified nedpoint FiskInfo:
These endpoints would previously return an empty object if the request was not authorized. It will now return 401 if the request is not authorized:
New endpoints AIS:
As the Ports service is removed from
barentswatch.no
, the Ports API also will be removed 1st October 2020.
On
My page
you will find all your registered API clients.
All our APIs are now available at
, using the new login system. The old APIs running at
will be removed on the 1st of october 2020.
Migrating to the new API should be straight forward:
register a client on My Page (
), and use this to create a token (see Application registration and authentication)
some endpoints used PascalCase before, but all endpoints use camelCase now. Check if this affects your code.
use the new url
The old FiskInfo API used by chart plotters will not be removed on the 1st of October 2020, but will be supported for a longer time.
We have published updated API documentation using the OpenAPI standard (Swagger):
FiskInfo API:
https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=FiskInfo%20API
Sustainability in aquaculture API:
Polar lows API:
https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Polar%20Lows%20API
Ports API:
https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Ports%20API
Saltstraumen API:
https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Saltstraumen%20API
Waveforecast API:
https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Waveforecast%20API
We are in the process of publishing all API documentation here:
, and will announce on this blog when more documentation is available.