API Method: /api/photo/section/list
List sections within for a video.
Parameters
Parameter | Description |
---|---|
photo_id (required) | The ID of the video to fetch sections for. |
token (required) |
The corresponding token for the photo_id. The token may be explicitly time-limited in which case expire becomes a required parameter. |
Permission level
The minimum required permission level is:
none
For non-public sites, the minimum level is:
anonymous
Example XML Response
<response status="ok" permission_level="anonymous"
total_count="6" cached="1" cache_time="1296413456">
<section section_id="7890" start_time="0"
title="It was the best of times"
link="/video/12345/7890/it-was-the-best-of-times"
thumbnail_photo_id="12345" thumbnail_tree_id="7340"
thumbnail_token="71a669eee625655a86cebcbad92e043"
quad100_download="/7340/12345/71a669eee625655a86cebcbad92e043/quad100"
quad50_download="/7340/12345/71a669eee625655a86cebcbad92e043/quad50"
standard_download="/7340/12345/71a669eee625655a86cebcbad92e043/standard"
portrait_download="/7340/12345/71a669eee625655a86cebcbad92e043/portrait"
medium_download="/7340/12345/71a669eee625655a86cebcbad92e043/medium"
small_download="/7340/12345/71a669eee625655a86cebcbad92e043/small"
quad16_download="/7340/12345/71a669eee625655a86cebcbad92e043/quad16"
large_download="/7340/12345/71a669eee625655a86cebcbad92e043/large"
quad75_download="/7340/12345/71a669eee625655a86cebcbad92e043/quad75">
<description>A multi-
line
description</description>
</section>
...
</response>
Example JSON Response
{
"status": "ok",
"permission_level":"anonymous",
"cached":"1",
"cache_time":"1296413646",
"sections":[
{"section_id": "12345", "start_time": "0",
"title": "It was the best of times",
"link": "/video/12345/12345/it-was-the-best-of-times",
"thumbnail_photo_id": "12345", "thumbnail_tree_id": "7340",
"thumbnail_token": "71a669eee625655a86cebcbad92e043",
"quad100_download": "/7340/12345/71a669eee625655a86cebcbad92e043/quad100",
"quad50_download": "/7340/12345/71a669eee625655a86cebcbad92e043/quad50",
"standard_download": "/7340/12345/71a669eee625655a86cebcbad92e043/standard",
"portrait_download": "/7340/12345/71a669eee625655a86cebcbad92e043/portrait",
"medium_download": "/7340/12345/71a669eee625655a86cebcbad92e043/medium",
"small_download": "/7340/12345/71a669eee625655a86cebcbad92e043/small",
"quad16_download": "/7340/12345/71a669eee625655a86cebcbad92e043/quad16",
"large_download": "/7340/12345/71a669eee625655a86cebcbad92e043/large",
"quad75_download": "/7340/12345/71a669eee625655a86cebcbad92e043/quad75",
"description": "A multi-\nline \ndescription"
}, ...],
"p": "1",
"size": "1",
"total_count": "6",
"site": {...},
"endpoint": "/api/photo/section/list"
}