User:Ommina: Difference between revisions

User:Ommina (view source)

Revision as of 11:39, 25 February 2010

975 bytes added , 25 February 2010

→‎CALENDAR: Get Upcoming Titles

Ommina

Bureaucrats, Administrators

358

edits

@@ Line 3: / Line 3: @@
 === CATEGORY: Retrieve Category Data ===
-=== CALENDAR: Get Upcoming Titles ===
+=== UPDATED: Get List of Updated Anime IDs ===
-Returns the anime ids of the next ten anime due to be aired / released, ordered by start date.
+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:'''
-* CALENDAR
+* UPDATED entity=1&[age={int4 id}|time={int4 date}]
 '''Possible Replies:'''
-* 297 CALENDAR
+* 243 UPDATED
-{int aid}|{int startdate}|{int dateflags}/n
+{int entity}|{bool isByAgeParameter}|{int count}|{int last update date}|{list aid}
-..repeated nine times
+* 343 NO UPDATES
-* 397 CALENDAR EMPTY
+'''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 change 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
+* ''isByAgeParameter'' will be 1 if "age=" is specified.  ( --> Is this even necessary?  What does it offer beyond looking silly? <-- )
+* ''count'' specifies the number of items returned in the list. ( --> This also seems silly, clients can count the number of items easily enough.  Maybe return the total number of items instead <-- )
+* ''last update date'' will contain the AniDB update time of the ''last'' aid to appear on the list
-'''Info:'''
+'''An anime will be considered updated if:'''
-* Takes no parameters (other than the session string)
+* A change is made to the anime record itself
-* Titles returned are filtered by the 'show adult' preference of the logged in user.  That is, users who have elected to hide adult content will have it hidden here as well.
+* An anime title is added, edited, or deleted
-* Date flags are used to indicated an unknown value (unknown month, unknown day)
+* An episode for the anime is added, or delete (but NOT edited!) ( --> But perhaps airdate changes should <-- )
-* ''dateflags'' values: [Look them up]
+* 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
 === REVIEW: Get Anime Review ===

User:Ommina: Difference between revisions

User:Ommina (view source)

Revision as of 11:39, 25 February 2010

Navigation menu