[RESTful Web-service Documentation v1.0]
go top

poll

returns a list of media id's to get media items are added, changed or deleted since you last polling (this is not available for partner media data. For partner media real-time search is required).

With the method get-media-info you can get then the meta-data for your own search algorithm (search-engine).

See the method download-image-preview to cache preview (thumb) files.

Parameter

Parameter (*=required)
Possible values
Default value
Description
type * [string] single value
  • new
  • changed
  • deleted


last_polling * [string] single value

  • date in UTC format
  • media id


for an initial import use media id "1" with type "new"
and save the current date for future polling.

offset [integer] 0

limit [integer 1-1000] 100
allowed values are between 1 and 1000

User-Authentication

 not required

Endpoint

http://rest.panthermedia.net/poll

Sample Request

POST http://rest.panthermedia.net/poll
Accept-Version: 1.0
Content-Type: application/x-www-form-urlencoded
api_key=a5e7b0dada779347e0fdd4db91ad883d0592aaca031e2c81234f3cb8008fdd1f&access_key=9de82c2a78df66e615274eec2622b53795abb2dd&timestamp=Thu%2C%2002%20Aug%202012%2005%3A54%3A55%20UTC&nonce=123&algo=sha1&type=new&last_polling=Sun%2C%2001%20Jan%202006%2001%3A01%3A00%20UTC

Sample Answer

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsp stat="ok">
  <items type="new" total="137" items="20">
    <media id="78771"/>
    <media id="80696"/>
    <media id="115372"/>
    <media id="197346"/>
    <media id="197348"/>
    <media id="197350"/>
    <media id="197352"/>
    <media id="197355"/>
    <media id="197356"/>
    <media id="197357"/>
    <media id="197358"/>
    <media id="197359"/>
    <media id="197364"/>
    <media id="197367"/>
    <media id="197369"/>
    <media id="197370"/>
    <media id="197372"/>
    <media id="197373"/>
    <media id="197374"/>
    <media id="197377"/>
  </items>
</rsp>