Jaisen Mathai 50b02ab258 Fixing lots of errors in the documentation.

Gh-180

2011-11-30 13:01:26 -08:00

4.7 KiB

Raw Blame History

Open Photo API / Get Next/Previous Photo

OpenPhoto, a photo service for the masses

Purpose
Endpoint
Parameters
Examples

Command line
PHP

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), The photo sizes you'd like in the response. Specify every size you plan on using. 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");

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"
    }
  }
}

4.7 KiB Raw Blame History