baumstern / location-history-server

Location History Server

HISTORY_SERVER_LISTEN_ADDR: default is 8080

HTTP endpoints

• PUT /location/{order_id}
• GET /location/{order_id}?max=<N>
• DELETE /location/{order_id}

PUT /location/{order_id}

append a location to the history for the specified order.

Example interaction:

PUT /location/def456
{
	"lat": 12.34,
	"lng": 56.78
}

200 OK

GET /location/{order_id}?max=<N>

Retrieve at most N items of history for the specified order. The most recent locations (in chronological order of insertion) should be returned first, if history is truncated by the max parameter.

Example interaction:

GET /location/abc123?max=2

200 OK
{
	"order_id": "abc123",
	"history": [
		{"lat": 12.34, "lng": 56.78},
		{"lat": 12.34, "lng": 56.79}
	]
}

The max query parameter may or may not be present. If it is not present, the entire history should be returned.

DELETE /location/{order_id}

delete history for the specified order. Example interaction:

DELETE /location/xyz987

200 OK