api photo get

API

photo.get

Retrieve photo data.

require read grant access

Request example

GET http://example.com/api/get/photo.get/json/?id=123456&fields[]=title&fields[]=thumb-url&fields[]=visible

{
	"method"  : "photo.get",
	"request" : 
	{
		"id"     : 123456,
		"fields" : [ "title", "thumb-url", "visible" ]
	}
}

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<xml>
	<method>photo.get</method>
	<request>
		<id>123456</id>
		<fields>title</fields>
		<fields>thumb-url</fields>
		<fields>visible</fields>
	</request>
</xml>

Response example

{
	"status"   : "valid",
	"response" : 
	{
		"title"     : "A beautiful butterfly",
		"thumb-url" : "http://www.something.com/photoblog/photos/thumb/AP3BJD4SIAZEOFFFFFMAZEKT.jpeg",
		"visible"   : true
	}
}

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<xml>
	<status>valid</status>
	<response>
		<title>A beautiful butterfly</title>
		<thumb-url>http://www.something.com/photoblog/photos/thumb/AP3BJD4SIAZEOFFFFFMAZEKT.jpeg</thumb-url>
		<visible>1</visible>
	</response>
</xml>

Arguments

• id: The photo ID.
• fields: an array of field: id | filename | title | description | publish-date | visible | thumb-url | resized-url | original-url.

NOTE: thumb-url and resized-url photo size can be known by using photo.size API method. original-url photo size is always unknown.

Return values

NOTE:
publish-date : follow RFC 3339
visible : returned as boolean