User Tools

Site Tools


icecondor:api

web/SVG version

Introduction

input format: HTTP get/post variables
output format: JSON
success/error reporting: HTTP response code

IDs/URIs

the id field in icecondor is a URI, with some standard URNs defined.

A person is generally defined by their OpenID URL.

http://openid_server/username

If there is no identified URL for the user, a regular uuid can be generated.

urn:uuid:7a13feb0-829d-11dd-ad8b-0800200c9a66

The follow URNs are used to build an icecondor id when the MAC address of a wifi access point or a bluetooth device are known.

urn:wifi:00:11:22:33:44:55
urn:bluetooth:00:11:22:33:44:55

Update location

POST /locations
input:
  client[version]="YYYYMMDD"
  location[timestamp]=<2008-09-05T22:00+0000 (ISO8601)> 
  location[guid]=<openid url> 
  location[latitude]=<float> 
  location[longitude]=<float> 
  location[altitude]=<altitude in meters>
  location[accuracy]=<horizontal accuracy in meters>
  location[velocity]=<speed in meters/s>
  location[heading]=<direction in degrees>
  or
  location[guid]=<openid url> location[next_to]=<other guid> location[radius]=<in meters> (unimplemented)
output:
GET /locations?id=<guid>
input:
  search filters:
    radius=<radius> - return the last record for any ids in the radius
    lat=<lat> - center the search on this lat/long
    long=<long>
    alt=<alt> (optional)
   or
    id=<id> - center the search on the last location for this id
    limit=<count>
output:
  returns the most recent post.
  [id,lat,long,alt,time,radius]
icecondor/api.txt · Last modified: 2016/06/25 11:25 (external edit)