Zur Übersicht

URL-Synopsis

   http://api.golem.de/api/article/images/article_identifier/?key=developerkey&format=resultformat
   http://api.golem.de/api/article/images/article_identifier/?key=developerkey
  

Function

Returns a list of images associated with an article.

Note: The list of images may not contain all images visible on the Golem.de website due to copyright reasons.

Arguments

Name Datatype Meaning Default value
article_identifier Integer The identifier of the article to retrieve the meta data for. Value required
developerkey String A valid developer key Value required
resultformat String The format of the result set (Allowed values: json or xml) json

Returns

The result data is encoded in UTF-8.

Name Datatype Meaning
success Boolean Indicates, wether the request could be successfully handle (true) or not (false).
data Array The list of images of an article
errorCode Integer The error code, if the request was not successful
errorMessage String The error message, if the request was not successful

Data Array

data is an array of image entries. Each entry consists of:

Name Datatype Meaning
imageid Integer The image identifier. The identifier should be not expected to be unique!
subtext String A text associated with the image.
small Array The data for the image as thumbnail. The typical size of an thumbnail is 120x90 pixel.
    url String The image url
    width Integer The image width in pixel
    height Integer The image height in pixel
medium Array The data for the image in a medium size. The maximum width of a medium size image is 480 pixel. The height may differ.
    url String The image url
    width Integer The image width in pixel
    height Integer The image height in pixel
native Array The data for the image. The size of the image is not limited, but a size of 1024x786 is exceeded in rare situations only.
    url String The image url
    width Integer The image width in pixel
    height Integer The image height in pixel

Error codes

Code Meaning
1 Internal Data access error
10 Article identifier is missing or invalid

Test output with a resultset as JSON

{"__className":"stdClass","data":[{"imageid":12345,"subtext":"Lorem ipsum dolor
sit amet consectetuer sadipscing elitr sed","small":{"url":"http://api.golem.de
/img/example_120.png","height":"90","width":"120"},"medium":{"url":"http://api.
golem.de/img/example_480.png","height":"270","width":"480"},"native":{"url":"ht
tp://api.golem.de/img/example_native.png","height":"535","width":"800"}},{"imag
eid":12345,"subtext":"Lorem ipsum dolor sit amet consectetuer sadipscing elitr
sed","small":{"url":"http://api.golem.de/img/example_120.png","height":"90","wi
dth":"120"},"medium":{"url":"http://api.golem.de/img/example_480.png","height":
"270","width":"480"},"native":{"url":"http://api.golem.de/img/example_native.pn
g","height":"535","width":"800"}},{"imageid":12345,"subtext":"Lorem ipsum dolor
 sit amet consectetuer sadipscing elitr sed","small":{"url":"http://api.golem.d
 e/img/example_120.png","height":"90","width":"120"},"medium":{"url":"http://ap
 i.golem.de/img/example_480.png","height":"270","width":"480"},"native":{"url":
 "http://api.golem.de/img/example_native.png","height":"535","width":"800"}},{"
 imageid":12345,"subtext":"Lorem ipsum dolor sit amet consectetuer sadipscing e
 litr sed","small":{"url":"http://api.golem.de/img/example_120.png","height":"9
 0","width":"120"},"medium":{"url":"http://api.golem.de/img/example_480.png","h
 eight":"270","width":"480"},"native":{"url":"http://api.golem.de/img/example_n
 ative.png","height":"535","width":"800"}},{"imageid":12345,"subtext":"Lorem ip
 sum dolor sit amet consectetuer sadipscing elitr sed","small":{"url":"http://a
 pi.golem.de/img/example_120.png","height":"90","width":"120"},"medium":{"url":
 "http://api.golem.de/img/example_480.png","height":"270","width":"480"},"nativ
 e":{"url":"http://api.golem.de/img/example_native.png","height":"535","width":
 "800"}}],"success":true}
  

Test output with a resultset as XML

<?xml version="1.0" encoding="UTF-8"?>
<golemderesult>
<success>1</success>
<data>
<record>
<imageid>12345</imageid>
<subtext>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</subtext>
<small>
<url>http://api.golem.de/img/example_120.png</url>
<height>90</height>
<width>120</width>
</small>
<medium>
<url>http://api.golem.de/img/example_480.png</url>
<height>270</height>
<width>480</width>
</medium>
<native>
<url>http://api.golem.de/img/example_native.png</url>
<height>535</height>
<width>800</width>
</native>
</record>
<record>
<imageid>12345</imageid>
<subtext>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</subtext>
<small>
<url>http://api.golem.de/img/example_120.png</url>
<height>90</height>
<width>120</width>
</small>
<medium>
<url>http://api.golem.de/img/example_480.png</url>
<height>270</height>
<width>480</width>
</medium>
<native>
<url>http://api.golem.de/img/example_native.png</url>
<height>535</height>
<width>800</width>
</native>
</record>
<record>
<imageid>12345</imageid>
<subtext>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</subtext>
<small>
<url>http://api.golem.de/img/example_120.png</url>
<height>90</height>
<width>120</width>
</small>
<medium>
<url>http://api.golem.de/img/example_480.png</url>
<height>270</height>
<width>480</width>
</medium>
<native>
<url>http://api.golem.de/img/example_native.png</url>
<height>535</height>
<width>800</width>
</native>
</record>
<record>
<imageid>12345</imageid>
<subtext>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</subtext>
<small>
<url>http://api.golem.de/img/example_120.png</url>
<height>90</height>
<width>120</width>
</small>
<medium>
<url>http://api.golem.de/img/example_480.png</url>
<height>270</height>
<width>480</width>
</medium>
<native>
<url>http://api.golem.de/img/example_native.png</url>
<height>535</height>
<width>800</width>
</native>
</record>
<record>
<imageid>12345</imageid>
<subtext>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</subtext>
<small>
<url>http://api.golem.de/img/example_120.png</url>
<height>90</height>
<width>120</width>
</small>
<medium>
<url>http://api.golem.de/img/example_480.png</url>
<height>270</height>
<width>480</width>
</medium>
<native>
<url>http://api.golem.de/img/example_native.png</url>
<height>535</height>
<width>800</width>
</native>
</record>
</data>
</golemderesult>
  


Zur Übersicht