SUBMITTING SIGHTINGS

This API will allow 4 sighting submissions per day (with up to 5 photos per submission). This allows developers to test the system.

To increase the daily quota, or to change the required expertise level or speed of response, or for any other issues re the API, contact us.

Please try to avoid writing code that might disrupt the experience of other users of this system, and if you have any questions or concerns about the impact of your code, kindly contact us before testing live.

BASE_URL: "https://api.questagame.com"

LOGIN:

curl -X POST \

 https://api.questagame.com/api/login \

 -H 'cache-control: no-cache' \

 -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \

 -H 'x-app-version: 20' \

 -F email=email@domain.com \

 -F password=password


STEP 1 - SET THE “ EXPERTISE LEVEL SOUGHT” AND “RESPONSE SPEED”
All sightings are verified by at least two experts in the category.
The “user_equipment” determines
- the level of expertise the sighting is likely to receive
- how quickly the sighting will get identified

POST /api/user/update_user_equipment

Params:

equipment_id:
Set to 116, which will provide “medium” level expertise, with a “high” response speed.
Accepted value: 116

headers: X-AUTH-KEY

STEP 2 - UPLOAD SIGHTING

params:

POST /api/sighting/new

Params:

accuracy
Determines accuracy of location data. Keep it set to 5.
Accepted value:

lat
Latitude of sighting.
Accepted value: Example = -30.738238

lng
Longitude of sighting.
Accepted value: Example = 76.232301

location_name
Location expressed as a text address.
Accepted value: Example = 75 Eureka Street, Cairns, Australia

manual_location
True if user manually selected location in the app; false if taken from the geotag.
Accepted value: true, false.

category_id  
General category of the specimen.
Accepted value: Can leave blank and system will automatically categorise; or can categorise with the following numerical values:
17 = Birds (e.g. feathered modern dinosaurs).
18 = Arachnids (e.g. spiders, scorpions, mites and ticks).
19 = Other Arthropods (similar to an insect, arachnid or crustacean).
20 = Other Insects (any insect not in the other insect categories)
21 = Other Invertebrates (e.g. worms, molluscs, corals and jellyfish).
22 = Crustaceans (e.g. crabs, crayfish, shrimp and wood-lice).
23 = Mammals (e.g. animals with hair).
24 = Amphibians (e.g. frogs and salamanders).
25 = Reptiles (e.g. lizards, snakes, crocodiles and turtles).
26 = Insects - Butterflies and Moths (including caterpillars).
27 = Fungi and Friends (including lichens and slime moulds).
28 = Non-Flowering Plants (e.g. ferns, conifers, mosses and green algae).
29 = Flowering Plants (plants which can produce flowers and fruit).
30 = Fish (e.g. bony fish, rays, sharks, and jawless fish).
34 = Insects - Beetles (including the larvae that become beetles).
35 = Insects - Ants, Bees and Wasps (also includes sawflies; these groups are closely related).
36 = Insects - Flies (includes common and rare flies and mosquitoes).
37 = Other Life (e.g. bacteria and blue-green algae).

device_type
Describes the device through which the sighting is submitted and/or your site or app.
Accepted values: Examples = android, ios, web, NatureMapr_android, NatureMapr_ios, etc

offline
True means the image is loaded from the device gallery; false means it’s loaded direct from within the app’s camera.
Accepted values: true, false

date
Date of upload.
Accepted values: Example = 16/10/2018. 

sighting_dttm
Photo’s data stamp, i.e. time image taken.
Accepted values:
Example = 16-10-2018 11:03:25

bonus_values
Field notes.
Accepted values: {“\"Field Notes\”:\”text notes go here\"}

image_url_1
Image being uploaded
Accepted values Example = #<UploadIO:0x00000002d1d7e0 @content_type=“image/jpeg", @original_filename=“1.jpeg", @local_path="/tmp/RackMultipart20190415-10691-ntuk3u", @io=#<Tempfile:/tmp/RackMultipart20190415-10691-ntuk3u>, @opts={}>