Cetaceans





Cetaceans database


The Cetaceans data portal web services provide the ability to search and retrieve data from database by providing access to the data.

Each part of the web services is provided by a web service API, which defines the name, input to, and output from the service for a particular request.

This page lists all the cetaceans web service APIs with a description that includes the information provided by the API, the input needed to get data from the API, and the data that is returned by the API.

The following web service APIs are provided:


Name getListSubmissions
Description In this webservice the user can get the list of all the files in the database.
Example Example to get the list of all the submissions
 
Name getIdentifiers
Description In this webservice the user can get the Identifiers records of the files in the database.

In this webservice, optionally the user can be authenticated using a JSON Web Token (JWT) and then they will have access to all the public records and the records from their organization.
Example Example to get the all public records of Identifiers
 
Name getEffortAndEnvironment
Description In this webservice, optionally the user can be authenticated using a JSON Web Token (JWT) and then they will have access to all the public records and the records from their organization.

In this webservice, optionaly the user can be autenticated using a Json Web Token (JWT) and then it will have access to all the public records and the records from his organization.
Example Example to get the all public records of Effort And Environment
 
Name getSightings
Description In this webservice, optionally the user can be authenticated using a JSON Web Token (JWT) and then they will have access to all the public records and the records from their organization.

In this webservice, optionaly the user can be autenticated using a Json Web Token (JWT) and then it will have access to all the public records and the records from his organization.
Example Example to get the all public records of Sightings
 
Name GetTotalSightingsperCsquareAndYear
Description Number of sightings for all species per year and C-square grid cell where the sea state is either calm, light air, light breeze or gentle breeze (seastate <= 3).
Example Example to get the number of sightings for all species per year and C-square grid cell.
Example to get the number of sightings for all species for the years of 2014 and 2016.
 
Name GetTotalSightingsperCsquareAndSpeciesAndYear
Description Number of sightings per species, year and C-square grid cell where the sea state is either calm, light air, light breeze or gentle breeze (seastate <= 3).
Example Example to get the number of sightings for all species per year and C-square grid cell.
Example to get the number of sightings for all species for the years of 2014 and 2016.
 
Name GetNumberOfUniqueSpeciesRecordedperCsquareandYear
Description Number of unique species recorded per grid (observed species richness); where the sea state is either calm, light air, light breeze or gentle breeze (seastate <= 3).
Example Example to get the number number of unique species recorded per year and C-square grid cell.
Example to get the number number of unique species recorded per year and C-square grid cell for the years of 2014 and 2016.
 
Name GetEffortInKMperCsquareandYearAllSeaStates
Description Effort in km per C-square grid cell showing total effort in km in all sea states.
Example Example to get the number number of effort in km per year and C-square grid cell.
Example to get the number number of effort in km per year and C-square grid cell for the years of 2014 and 2016.
 
Name GetEffortInKMperCsquareandYearGoodSeaState
Description Effort in km per C-square grid cell showing total effort in km where the sea state is either calm, light air, light breeze or gentle breeze (seastate <= 3).
Example Example to get the number number of effort in km per year and C-square grid cell.
Example to get the number number of effort in km per year and C-square grid cell for the years of 2014 and 2016.
 
Name Token
Description In this webservice the user can request a JSON Web Token (JWT) to be able to make requests to the webAPI that require authentication.
Input [Body (Form Data)]
User (ICES user name)
Password (current password for the ICES user, same that you use in the ICES sharepoint)
Output If it succeds, then it will return you the JWT token, you can read more about it here.
URL (POST) https://cetaceans.ices.dk/API/token
 
Name ScreenCetaceansFile
Description In this webservice the user can upload a file to be screen and validated by the European Seabirds at Sea database.
The service can be called using post and the file will have to be part of the body of que call. The user needs to be autenticated in order to call this service.
This file can be later pushed to the database by the same user.
Input
fileToScreen (FileStream part of the Body form-data)
SendMail (Is defines if a mail is send when it ends and it is passed in the url)
Output It returns the tblFileScreeninID and this can be used later to query the file screening for messages, status or in case the screening is finished and free of errors to push the file to the database.
URL (POST) https://cetaceans.ices.dk/API/ScreenCetaceansFile
 
Name getScreeningDetails/{ID}
Description In this webservice the user can a get the details of a screening session, no autentication is needed.
Example Example to get the details of session 7
 
Name getScreeningSessionMessages/{ID}
Description In this webservice the user can a get the list of messages from a screening session, no autentication is needed.
Example Example to get the list of messages from session 7