Skip to content

Recently updated list

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

###Description:

Return the recently updated streams, for every stream include the 10 latest photos. This method doesn't include locked streams

###URL: GET http://public-api.piictu.com/v2/streams

###HTTP method(s): GET

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

###Parameters:

  • page (optional:integer): Specifies the page of results to retrieve, default = 1.
  • rpp (optional:integer): results per page, default =10, max = 50.
  • since_seq (optional:integer): Returns results with an SEQ greater than (that is, more recent than) the specified SEQ.
  • max_seq (optional:integer): Returns results with an SEQ less than (that is, older than) or equal to the specified SEQ.

###Usage example:

Example using cURL:

curl -i http://public-api.piictu.com/v2/streams \
 -F page=2 \
 -X GET \
 -H "Authorization: OAuth 2540af0de12cb2367691516b8477b0b7bd66dbd8ab6840b147340c6898c4eebd"

###Response:

On success

  • HTTP response code is 200 (ok)
  • HTTP response body is a JSON string like this:
{
  "current_page": 1,
  "results_per_page": 10,
  "total_entries": 54667,
  "total_pages": 5467,
  "next_page": "?page=2&rpp=10",
  "streams": [
    {
    "stream": {
      "created_at": "2012-02-18T17:58:31Z",
      "featured": false,
      "photos_count": 2,
      "popular": false,
      "staff_favorite": false,
      "title": "A",
      "trending": false,
      "updated_at": "2012-02-18T18:02:21Z",
      "users_count": 2,
      "id": "4f3fe6c7041d3f0001000001",
      "original_photo": {
      "photo": {"caption": "A"}
      },
      "from": {
      "avatar_url": "http://piictu.s3.amazonaws.com/avatars/4deea01af618b90001000140/90x90_1316562551",
      "bio": "Building Piictu - @nslimak",
      "fullname": "Noah Slimak",
      "username": "noah",
      "id": "4deea01af618b90001000140"
      },-
      "seq": 13295881416693258,
      "photos": [
        {
          "photo": {
          "caption": "A",
          "created_at": "2012-02-18T17:58:31Z",
          "seq": 13295879116981614,
          "url": "http://cdn-staging.piictu.com/photos%2F4f3fe6c3f642c60001000001%2Foriginal",
          "id": "4f3fe6c3f642c60001000001",
          "stream_id": "4f3fe6c7041d3f0001000001",
          "thumbnail": "http://cdn-staging.piictu.com/photos%2F4f3fe6c3f642c60001000001%2F90x90",
          "stream_title": "A",
          "from": {
            "avatar_url": "http://piictu.s3.amazonaws.com/avatars/4deea01af618b90001000140/90x90_1316562551",
            "bio": "Building Piictu - @nslimak",
            "fullname": "Noah Slimak",
            "username": "noah",
            "id": "4deea01af618b90001000140"
          },
          "likes": ["4dcafa8a6561120001000007"],
          "type": 1
          }
        }]
      }
    },
    ...
    ]
}

Clone this wiki locally