User:Ommina

From AniDB
Jump to navigation Jump to search

CATEGORY: Retrieve Category Data

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

CALENDAR: Get Upcoming Titles

Returns the anime ids of the 25 most recently aired / released anime, directly followed by the next 25 anime due to be aired / released, ordered by start date.

Command String:

  • CALENDAR

Possible Replies:

  • 297 CALENDAR

{int aid}|{int startdate}|{int dateflags}/n

..repeated n times

  • 397 CALENDAR EMPTY

Info:

  • Takes no parameters (other than the session string)
  • 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.
  • Don't depend on the command always returning exactly 50 titles, there may not always be 25 future titles pending, depending on the user's 'adult' preferences, and the date in relation to the relation to the current anime season.
  • Date flags are used to indicated an unknown value (unknown month, unknown day)
  • dateflags values:
    • bit0 set == Startdate, Unknown Day
    • bit1 set == Startdate, Unknown Month
    • bit2 set == Enddate, Unknown Day
    • bit3 set == Enddate, Unknown Month
    • bit4 set == Startdate, Unknown Year
    • bit5 set == Enddate, Unknown Year

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?]

WISHLIST: Retrieve Wishlist Data

WISHLISTADD: Add Anime to Wishlist

WISHLISTDEL: Remove Anime from Wishlist

NOTIFICATION: Retrieve Notification Date

NOTIFICATIONADD: Add Anime or Group to Notify List

NOTIFICATIONDEL: Remove Anime or Group from Notify List

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