API - Identification Results

SUBMITTING IDENTIFICATIONS (WITH $ REWARD FOR CORRECT IDS)

This API allows your community to identify sightings and earn money for your nominated organisation. To customise the sightings you receive through this API, login to - or create an account on - BioExpertise.org and go to Menu > Settings. There you can select the categories and region for your account. To nominate an organisation that can receive funds, go to the Profile > Select Organisation. If you organisation is not listed, you can enrol your organisation here (the organisation must be able to accept donations).

Note that in the API below “Remarkability Rating” is a required field.

Here's the basic criteria your community should follow:

We strongly encourage you to distribute your ratings across the 1-5 scale as best you can.

In other words, please don't rate everything the same (even if you think they’re all the same), but rather scale it evenly across the sightings you’re rating. The ratings given may influence future expertise levels.

See a sample

——————-

base_url: https://bee.questagame.com

1) LOGIN

POST /api/session.json

params = {email: "email@domain.com", password: "password"}

2) TO GET A SIGHTING TO ID

GET /api/home/show_sighting

headers:

Authorization: <- user token got after login ->

Content-Type: application/json

Accept: application/json

3) TO SKIP SIGHTING

GET /api/home/show_sighting

params: skip = <- sighting_id that need to skip e.g. 207952 ->

headers:

Authorization: <- user token got after login ->

Content-Type: application/json

Accept: application/json

4) SCIENTIFIC NAME SUGGESTIONS

GET https://api.gbif.org/v1/species/suggest

params:

q = searsia (where searsia is the typed text)

5) SUBMIT ID

POST /api/home/expert_comment

payload = {"comment":"this is comment","sciname":"Schizocladiophyceae","rank":"ANY","ptk_amount":0.19,"field_notes_rating":4,"photo_rating":5,"remarkable_rating":4,"extra_facts":"yes this is species fact","sighting_id":208041}

headers:

Authorization: <- user token got after login ->

Content-Type: application/json

Accept: application/json

Example url: http://tinyurl.com/yxpemxx8