Get Photo

Purpose
Endpoint
Parameters
Examples

Command line
PHP
Python

Response

Sample

Purpose of the Get Photo API

Use this API to get a for a user's photo.

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/view.json

Parameters

returnSizes (optional), (e.g. 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/view.json

PHP (using openphoto-php)

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

Python (using openphoto-python)

client = openphoto.OpenPhoto()
photo = client.photos.list()[0] # Returns the first photo from the list
photo.view(returnSizes="20x20")
print(photo.path20x20)

    http://current.openphoto.me/photo/c7/create/baad9/20x20.jpg

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, A Photo object

Sample

{
  "message":"",
  "code":200,
  "result":{
    "id":"hl"
    "tags":[
      ""
    ],
    "pathBase":"\/base\/201107\/1311045184-opme7Z0WBh.jpg",
    "appId":"opme",
    "host":"testjmathai1.s3.amazonaws.com",
    "dateUploadedMonth":"07",
    "status":"1",
    "hash":"fba49a238426ac3485af6d69967ccd2d08c1fe5c",
    "width":"569",
    "dateTakenMonth":"07",
    "dateTakenDay":"18",
    "permission":"0",
    "pathOriginal":"\/original\/201107\/1311045184-opme7Z0WBh.jpg",
    "exifCameraMake":"",
    "size":"0",
    "dateTaken":"1311045184",
    "height":"476",
    "views":"0",
    "dateUploadedYear":"2011",
    "dateTakenYear":"2011",
    "creativeCommons":"BY-NC",
    "dateUploadedDay":"18",
    "dateUploaded":"1311045188",
    "exifCameraModel":"",
    "path200x200":"\/custom\/201107\/1311045184-opme7Z0WBh_200x200.jpg",
  }
}

4 KiB Raw Blame History