User:Ommina

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}|{bool isByAgeParameter}|{int 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 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

An anime will be considered updated if:

• A change is made to the anime record itself
• An anime title is added, edited, or deleted
• 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

REVIEW: Get Anime Review

Retrieves the review scores and text for an anime review. Like ANIMEDESC, it will likely take multiple calls to this comment to retrieve a complete review - almost all reviews will overflow the size limits of a UDP packet.

Command String:

• REVIEW rid={int4 id}

Possible Replies:

• 234 REVIEW

{int4 current part}|{int4 max parts}|{int4 review id}|{int4 author uid}|{int4 score_animation}|{int4 score_sound}|{int4 score_story}|{int4 score_character}|{int4 score_value}|{int4 score_enjoyment}|{str review_text}

• 234 REVIEW

{int4 current part}|{int4 max parts}|{str review_text}

• 334 NO SUCH REVIEW

Info:

• IDs and scores are returned with part zero only. Parts one through max exclude the scores and return the text block only.

[Maybe exchange author uid for author name. Or a uid->name lookup via USER?]

Empty Table

Byte 1
Bit	Decimal	Data Field
0	1	String
1	2	String
2	4	String
3	8	String
4	16	String
5	32	String
6	64	String
7	128	String