Updates to our APIs (2021-03-04)
Added Fishhealth endpoints:
Added Fishhealth endpoints:
We have updated the documentation for application registration and authentication. It is now possible to log in with your own client_id to the OpenAPI documentation. Read more here: Application registration and authentication.
Updated endpoints:
Added new property 'isSlaughterHoldingCage' to these endpoints:
Added municipality info to this endpoint:
Changed when downloading Fishhealth Excel/CSV:
'Brakklagt' column is now called 'Trolig uten fisk'
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:
Along a predefined fairway: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Waveforecast%20API#/FairwayWeather/get_v1_geodata_fairway_wind__modelName___fairwayId___time_
Along a custom fairway: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Waveforecast%20API#/FairwayWeather/post_v1_geodata_fairway_custom_wind
Due to a new data source for ISA and PD diseases these changes have been made today:
new property "ilaPdCase" which will have data from week 45, 2020 from the new dataset (instead of the "ilapd" property)
Download (excel/csv):
added new columns for disease
fromdate/todate will be empty from week 45, 2020 (dates will be in the new columns.
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.
New endpoint in Sustainability in Aquaculure: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Sustainability%20In%20Aquaculture%20API#/Datasets/get_v1_geodata_bki_dataset_seafoodsafety
Updated Waveforecast endpoint: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Waveforecast%20API#/Waveforecast/get_v1_geodata_waveforecast_modelrundatetime
New AIS endpoint:
Sustainability in aquaculture:
Removed endpoint:
/v1/geodata/bki/dataset/salmontroutescapes/{year}/{month}
Added endpoints:
New waveforecast endpoint:
New endpoints Fishhealth:
Get info about a fairway: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Fishhealth%20API#/Fairway/get_v1_geodata_fairways__id_
Updated data in Fishhealth:
The API no longer includes info about cleaner fish treatments from week 16, 2018 or later. This data was incomplete due to transition to new reporting.
New endpoints Fiskinfo:
Get all downloadable datasets: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=FishInfo%20API#/Download/get_v1_geodata_service_downloadable
Get info about a downloadable dataset: https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=FishInfo%20API#/DownloadableDatasets/get_v1_geodata_service_downloadable__datasetname_
New endpoints for FishHealth:
Get information about a cod spawningground https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Fishhealth%20API#/CodSpawningGround/get_v1_geodata_codspawningground__id_
Get information about a salmonfjord https://www.barentswatch.no/bwapi/openapi/index.html?urls.primaryName=Fishhealth%20API#/SalmonFjord/get_v1_geodata_salmonfjord__id_
New endpoints current waves forecast for Langesund. Note that the enpoints do not yet have data.