Difference between revisions of "Talk:UDP API Definition"

From AniDB
Jump to navigation Jump to search
(Oops)
 
Line 1: Line 1:
==Error 602 - Reporting?==
+
=== UPDATED: Get List of Updated Anime IDs ===
 +
Returns a list of AniDB anime ids of anime that have been updated in in a given time frame, ordered by descending date.
  
Regarding the API errors (in [[UDP_API_Definition#General]]), should 602 (server busy) also be forwarded to epoximator? The note below states all but 601 should be reported, but this seems awkward. Cheers, [[User:Bjecas|Bjecas]] 03:41, 2 September 2008 (CEST)
+
'''Command String:'''
 +
* UPDATED entity=1&[age={int4 id}|time={int4 date}]
  
: There are logistical challenges forwarding bugs to epoximator, please send them to me instead (via the tracker, ideally).  I'm not especially interested in 602 if it is (very) infrequent, but would be concerned if it is being seen too often, as it might be a symptom of something else wrong.  --[[User:Ommina|Ommina]] 04:06, 2 September 2008 (CEST)
+
'''Possible Replies:'''
 +
* 243 UPDATED
 +
{int entity}|{int total count}|{int last update date}|{list aid}
  
::Errm, didn't know... Sorry :/ [[User:Bjecas|Bjecas]] 06:39, 21 September 2008 (CEST)
+
* 343 NO UPDATES
 +
 
 +
'''Info:'''
 +
* ''entity'' is always 1
 +
* Either ''age'' OR ''time'' can be specified, but not both
 +
* ''age'' is specified in days.
 +
** eg: age=30 requests a list of aid values of anime that have changed in the past 30 days
 +
* ''time'' is specified in unix time.
 +
** eg: time=1264982400 requests a list of aid values of anime that have changed since 2010-02-01
 +
* A maximum of 200 values will be returned
 +
* ''count'' specifies the total number of items found for the given time period. In short, if this value is great than 200, you have not retrieved all applicable ids.
 +
* ''last update date'' will contain the AniDB update time of the ''last'' aid to appear on the list
 +
 
 +
'''An anime will be considered updated if:'''
 +
* A change is made to the anime record itself
 +
* An ''main'' or ''official'' anime title is added, edited, or deleted (not ''short'' or ''synonym'')
 +
* An episode for the anime is added, or delete (but NOT edited!) ( --> But perhaps airdate changes should <-- )
 +
* An episode title is added, edited, or delete
 +
* An anime category is added, or deleted (but NOT edited: eg, weight change)
 +
* An anime relation is added, or deleted

Latest revision as of 00:20, 23 September 2014

UPDATED: Get List of Updated Anime IDs

Returns a list of AniDB anime ids of anime that have been updated in in a given time frame, ordered by descending date.

Command String:

  • UPDATED entity=1&[age={int4 id}|time={int4 date}]

Possible Replies:

  • 243 UPDATED

{int entity}|{int total count}|{int last update date}|{list aid}

  • 343 NO UPDATES

Info:

  • entity is always 1
  • Either age OR time can be specified, but not both
  • age is specified in days.
    • eg: age=30 requests a list of aid values of anime that have changed in the past 30 days
  • time is specified in unix time.
    • eg: time=1264982400 requests a list of aid values of anime that have changed since 2010-02-01
  • A maximum of 200 values will be returned
  • count specifies the total number of items found for the given time period. In short, if this value is great than 200, you have not retrieved all applicable ids.
  • last update date will contain the AniDB update time of the last aid to appear on the list

An anime will be considered updated if:

  • A change is made to the anime record itself
  • An main or official anime title is added, edited, or deleted (not short or synonym)
  • An episode for the anime is added, or delete (but NOT edited!) ( --> But perhaps airdate changes should <-- )
  • An episode title is added, edited, or delete
  • An anime category is added, or deleted (but NOT edited: eg, weight change)
  • An anime relation is added, or deleted