Get Next/Previous Photo

Purpose
Endpoint
Parameters
Examples

Command line
PHP
Python

Response

Sample

Purpose of the Get Photo API

Use this API to get the next and previous photo given a photo in the middle.

NOTE: Always pass in the returnSizes parameter for sizes you plan on using. It's the only way to guarantee that a URL for that size will be present in the response. See Photo Generation for details.

Endpoint

Authentication: optional

GET /photo/:id/nextprevious.json

Parameters

returnSizes (optional), (i.e. 20x20 or 30x30xCR,40x40) The photo sizes you'd like in the response. Specify every size you plan on using. Docs for this parameter
generate (optional), (i.e. true or false) Tells the API to generate the sizes from returnSizes instead of returning a create URL. Docs for this parameter

Examples

Command Line (using openphoto-php)

./openphoto -p -h current.openphoto.me -e /photo/b/nextprevious.json

PHP (using openphoto-php)

$client = new OpenPhotoOAuth($host, $consumerKey, $consumerSecret, $oauthToken, $oauthTokenSecret);
$response = $client->get("/photo/b/nextprevious.json");

Python (using openphoto-python)

client = openphoto.OpenPhoto()
photo = client.photos.list()[1] # Returns the second photo in the list
print photo.next_previous()

    {'previous': [<openphoto.objects.Photo id='1eo'>], 'next': [<openphoto.objects.Photo id='1eq'>]}

Response

The response is in a standard response envelope.

message, A string describing the result. Don't use this for anything but reading.
code, 200 on success
result, An array of Photo objects

Sample

{
  "message" : "Next\/previous for photo bq",
  "code" : 200,
  "result" : {
    "previous" : {
      "tags" : [

      ],
      "id" : "bo",
      "appId" : "openphoto-frontend",
      "pathBase" : "\/base\/201109\/1317155744-DSC_9243.JPG",
      "dateUploadedMonth" : "09",
      "dateTakenMonth" : "08",
      "exifCameraMake" : "NIKON CORPORATION",
      "dateTaken" : "1313454314",
      "title" : "",
      "height" : "2000",
      "description" : "",
      "dateTakenYear" : "2011",
      "longitude" : "",
      "dateUploadedDay" : "27",
      "host" : "opmecurrent.s3.amazonaws.com",
      "hash" : "7b923cbbe4f7aa81be144b1420a99711ad57106b",
      "status" : "1",
      "width" : "3008",
      "dateTakenDay" : "15",
      "permission" : "1",
      "pathOriginal" : "\/original\/201109\/1317155744-DSC_9243.JPG",
      "size" : "2502",
      "dateUploadedYear" : "2011",
      "views" : "0",
      "latitude" : "",
      "dateUploaded" : "1317155745",
      "exifCameraModel" : "NIKON D70s",
      "Name" : "bo",
      "exifFocalLength" : "35",
      "exifExposureTime" : "10\/600",
      "exifISOSpeed" : "",
      "license" : "",
      "exifFNumber" : "3.8"
    },
    "next" : {
      "tags" : [

      ],
      "id" : "63",
      "appId" : "current.openphoto.me",
      "pathBase" : "\/base\/201108\/1313010849-opmeTbrBki.jpg",
      "dateUploadedMonth" : "08",
      "dateTakenMonth" : "08",
      "exifCameraMake" : "",
      "dateTaken" : "1313010850",
      "title" : "Gulf Shores, AL",
      "height" : "1936",
      "description" : "",
      "creativeCommons" : "BY-NC",
      "dateTakenYear" : "2011",
      "dateUploadedDay" : "10",
      "longitude" : "-87.7008193",
      "host" : "opmecurrent.s3.amazonaws.com",
      "hash" : "20d64642f09befc4004c22269e698e6e43475963",
      "status" : "1",
      "width" : "2592",
      "dateTakenDay" : "10",
      "permission" : "1",
      "pathOriginal" : "\/original\/201108\/1313010849-opmeTbrBki.jpg",
      "size" : "1513",
      "dateUploadedYear" : "2011",
      "views" : "0",
      "latitude" : "30.2460361",
      "dateUploaded" : "1313010853",
      "exifCameraModel" : "",
      "Name" : "63"
    }
  }
}

5.5 KiB Raw Blame History