Skip to Content

TwentyThree

TwentyThree™ API

API Method: /api/photo/section/list

List sections within for a video.

Parameters

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