Zur Übersicht

URL-Synopsis

   http://api.golem.de/api/special/article/special/limit/?key=developerkey&format=resultformat
   http://api.golem.de/api/special/article/special/limit/?key=developerkey
   http://api.golem.de/api/special/article/special/?key=developerkey&format=resultformat
   http://api.golem.de/api/special/article/special/?key=developerkey
  

Function

Returns a list of limit articles from a special category.

Arguments

Name Datatype Meaning Default value
special String The short name of the special category. Value required
limit Integer The number of articles to fetch. The limit must be between 0 and 50. 5
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 articles, if the request was sucessful
errorCode Integer The error code, if the request was not successful
errorMessage String The error message, if the request was not successful

Data Array

The data represents the list of articles. Each article is represented by a single record. Each record consists of:

Name Datatype Meaning
articleid Integer The article identifier of the article
headline String(60) The headline of the article
abstracttext String The abstract text of the article
url String The URL of the article
date Integer The publishing date of the article as unix timestamp
images Integer The number of an images associated with the article.
leadimg Array Headline image data of the article
    url String URL of the headline image
    width Integer The image width
    height Integer The image height

Error codes

Code Meaning
1 Internal Data access error
102 Limit was not provided, or is outside the range
103 No special provided
104 Special does not exist

Test output with a single resultset as JSON

{"__className":"stdClass","data":[{"articleid":1,"headline":"Lorem ipsum dolor 
 sit amet consectetuer sadipscing elitr sed","abstracttext":"Lorem ipsum dolor
sit amet, consectetuer sadipscing elitr, sed diam nonumy eirmod tempor invidunt
ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accu
sam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimat
a sanctus est Lorem ipsum dolor sit amet.","url":"http://api.golem.de/","date":
123456789,"leadimg":{"url":"http://www.golem.de/api/img/golemapi_logo.png","hei
ght":90,"width":120},"images":5}],"success":true}
  

Test output with a single resultset as XML

<?xml version="1.0" encoding="UTF-8"?>
<golemderesult>
<success>1</success>
<data>
<record>
<articleid>1</articleid>
<headline>Lorem ipsum dolor sit amet consectetuer sadipscing elitr sed</headline>
<abstracttext>Lorem ipsum dolor sit amet, consectetuer sadipscing elitr, sed
 diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat,
 sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
 Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor si
 t amet.
</abstracttext>
<url>http://api.golem.de/</url>
<date>123456789</date>
<leadimg>
<url>http://www.golem.de/api/img/golemapi_logo.png</url>
<height>90</height>
<width>120</width>
</leadimg>
<images>5</images>
</record>
</data>
</golemderesult>
  


Zur Übersicht