User:Ommina: Difference between revisions

From AniDB
Jump to navigation Jump to search
(Undo revision 14804 by Ommina (Talk))
Line 3: Line 3:
=== CATEGORY: Retrieve Category Data ===
=== CATEGORY: Retrieve Category Data ===


=== UPDATED: Get List of Updated Anime IDs ===
=== CALENDAR: Get Upcoming Titles ===
Returns a list of AniDB anime ids of anime that have been updated in in a given time frame, ordered by descending date.
Returns the anime ids of the next ten anime due to be aired / released, ordered by start date.


'''Command String:'''
'''Command String:'''
* UPDATED entity=1&[age={int4 id}|time={int4 date}]
* CALENDAR


'''Possible Replies:'''
'''Possible Replies:'''
* 243 UPDATED
* 297 CALENDAR
{int entity}|{bool isByAgeParameter}|{int count}|{int last update date}|{list aid}
{int aid}|{int startdate}|{int dateflags}/n


* 343 NO UPDATES
..repeated nine times
 
* 397 CALENDAR EMPTY


'''Info:'''
'''Info:'''
* ''entity'' is always 1
* Takes no parameters (other than the session string)
* Either ''age'' OR ''time'' can be specified, but not both
* 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.
* ''age'' is specified in days.
* Date flags are used to indicated an unknown value (unknown month, unknown day)
** eg: age=30 requests a list of aid values of anime that have change in the past 30 days
* ''dateflags'' values: [Look them up]
* ''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 ===
=== REVIEW: Get Anime Review ===

Revision as of 09:46, 3 March 2010

CATEGORY: Retrieve Category Data

CALENDAR: Get Upcoming Titles

Returns the anime ids of the next ten 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 nine 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.
  • Date flags are used to indicated an unknown value (unknown month, unknown day)
  • dateflags values: [Look them up]

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