Developer Setup

This page is for developers. If you are looking to start managing your own location data with Coposition, see our help page.

Asking for approval

To begin with, you'll want to ask for approval from a user. You can do this from your developer console or by using the API. From the console, click 'New user' and enter the email of the user you would like to add. Alternatively, you can use the API.

API documentation reference
Asking for approval

Getting checkins

Once you have approval from a user, you can use the API to request their checkins. You'll need the User ID and optionally the ID of a specific device belonging to the user. You can find a list of your approved users and a list of devices belonging to each user using the API. You can then choose to request the most recent checkin or up to 1000 checkins, either belonging to the user, or for a specific device belonging to the user.

API documentation reference
List of users
List of devices
Getting checkins

Creating checkins

To allow a user to create checkins via your app, you will need to ask for the UUID of an existing device, or request a UUID and provide this to the user. The latter is recommended if you anticipate that you will want to add extra device settings that may not already be included for devices. You will need to ask the user to then log in and claim the device on Coposition.Once you have a UUID, a latitude and longitude are all that is needed to create a checkin.

API documentation reference
Requesting a UUID
Creating a checkin

Additional device settings

You can add additional, custom settings to any devices created from a UUID you have requested. Each device has an associated config, on which you can set any additional attributes under the custom attribute. The config can be updated and viewed using the API, the user can also view their device config on the coposition website.

API documentation reference
Updating device config
Copyright © 2017 Coposition
Terms and conditions