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: 5
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={}>