Skip to content

Track stream

Rafael Chacon edited this page Feb 22, 2012 · 1 revision

###URL: POST http://public-api.piictu.com/v2/trackings

###HTTP method(s): POST

###Requires authentication (Authentication and Authorization): Yes

###Parameters:

  • id id of the stream you want to track

###Usage example:

Example using cURL:

curl -i http://public-api.piictu.com/v2/trackings \
  -F id=4d6ebc4f5a0d032648000016 \
  -H "Authorization: OAuth 2540af0de12cb2367691516b8477b0b7bd66dbd8ab6840b147340c6898c4eebd" \
  -X POST

###Response:

On success

  • HTTP response code is 200 (ok)
  • HTTP response body is a JSON string like this:
{
    "success" : "true"
}

On error

When stream identified by id don't exist

  • HTTP response code is 404 (document not found)
  • HTTP response body is a JSON string like this:
{
    "error" : "document not found"
}

If the stream is locked and user neither is mentioned in the stream or is the stream's creator

  • HTTP response code of 403 (Forbidden)
  • HTTP response body is a JSON string like this:
{
  "error" : "user not authorized"
}

Clone this wiki locally