|
|
Line 370: |
Line 370: |
| </tr> | | </tr> |
| </table> | | </table> |
|
| |
| === FILE: Retrieve File Data ===
| |
| '''Command String:'''<br>
| |
| by fid:
| |
| * FILE fid={int4 id}[&fmask={hexstr fmask}&amask={hexstr amask}]
| |
| by size+ed2k hash:
| |
| * FILE size={int8 size}&ed2k={str ed2khash}[&fmask={hexstr fmask}&amask={hexstr amask}]
| |
| by anime, group and epno
| |
| * FILE aname={str anime name}&gname={str group name}&epno={int4 episode number}[&fmask={hexstr fmask}&amask={hexstr amask}]
| |
| * FILE aname={str anime name}&gid={int4 group id}&epno={int4 episode number}[&fmask={hexstr fmask}&amask={hexstr amask}]
| |
| * FILE aid={int4 anime id}&gname={str group name}&epno={int4 episode number}[&fmask={hexstr fmask}&amask={hexstr amask}]
| |
| * FILE aid={int4 anime id}&gid={int4 group id}&epno={int4 episode number}[&fmask={hexstr fmask}&amask={hexstr amask}]
| |
|
| |
| '''Possible Replies:'''
| |
| * 220 FILE
| |
| : {int4 fid}|{int4 aid}|{int4 eid}|{int4 gid}|{int4 state}|{int8 size}|{str ed2k}|{str anidbfilename}
| |
| * 220 FILE
| |
| : {int4 fid}|...(data list)
| |
| * 322 MULTIPLE FILES FOUND
| |
| : {int4 fid 0}|{int4 fid 1}|...|{int4 fid n}
| |
| * 320 NO SUCH FILE
| |
|
| |
| '''Info:'''
| |
| * fid, aid, eid, gid are the unique ids for the file, anime, ep, group entries at anidb.
| |
| : You can use those to create links to the corresponding pages at anidb.
| |
| * anidbfilename is the anidb filename for the file.
| |
| : However this name does not contain all the extra information of the filenames on AniDB and might be composed slightly different.
| |
| * fmask and amask are hexidecimal strings where each bit corresponds to a data field related to the specified file (see below). The data list received is sorted in the same order as the tables (and fmask before amask). There is '''no''' provision to retrieve all fields, further, requesting a 'unusued' or 'reserved' bit will return an "illegal input" error.
| |
| * Only the first matching file is returned when aname, gname and epno is used.
| |
|
| |
| '''State:'''
| |
| <pre>
| |
| bit / int value meaning
| |
| 1 / 1 FILE_CRCOK: file matched official crc (displayed with green background in anidb)
| |
| 2 / 2 FILE_CRCERR: file DID NOT match official crc (displayed with red background in anidb)
| |
| 3 / 4 FILE_ISV2: file is version 2
| |
| 4 / 8 FILE_ISV3: file is version 3
| |
| 5 / 16 FILE_ISV4: file is version 4
| |
| 6 / 32 FILE_ISV5: file is version 5
| |
| 7 / 64 FILE_UNC: file is uncensored
| |
| 8 / 128 FILE_CEN: file is censored
| |
|
| |
| examples:
| |
| state ==== 9 ==> FILE_CRCOK+FILE_ISV3 ==> file matched official crc and is version 3
| |
| state ==== 0 ==> - ==> file was not crc checked and is version 1
| |
| state ==== 34 ==> FILE_CRCERR+FILE_ISV5 ==> file DID NOT match official crc and is version 5
| |
| state ==== 1 ==> FILE_CRCOK ==> file matched official crc and is version 1
| |
| state ==== 8 ==> FILE_ISV3 ==> file was not crc checked and is version 3
| |
| </pre>
| |
|
| |
| <table border="0" cellpadding="0" cellspacing="2">
| |
| <tr><td colspan="4" align="center">'''fmask:'''</td></tr>
| |
| <tr>
| |
| <td align="center">'''Byte 1'''</td>
| |
| <td align="center">'''Byte 2'''</td>
| |
| <td align="center">'''Byte 3'''</td>
| |
| <td align="center">'''Byte 4'''</td>
| |
| </tr>
| |
| <tr>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>int4 aid</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>int4 eid</td>
| |
| </tr>
| |
| <tr>
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>int4 gid</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>int4 lid</td>
| |
| </tr>
| |
| <tr>
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>list other episodes</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>int2 IsDeprecated</td>
| |
| </tr>
| |
| <tr>
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>int2 state</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr>
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>int8 size</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>str ed2k</td>
| |
| </tr>
| |
| <tr>
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>str md5</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>str sha1</td>
| |
| </tr>
| |
| <tr>
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>str crc32</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>reserved</td>
| |
| </tr>
| |
| <tr>
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>str source</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>str audio codec</td>
| |
| </tr>
| |
| <tr>
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>int4 audio bitrate</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>str video codec</td>
| |
| </tr>
| |
| <tr>
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>int4 video bitrate</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>str video resolution</td>
| |
| </tr>
| |
| <tr>
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>str file type (extension)</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr>
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>str dub language</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>str sub language</td>
| |
| </tr>
| |
| <tr>
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>int4 length in seconds</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>str description</td>
| |
| </tr>
| |
| <tr>
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>int4 release date</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>str anidb file name</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| </tr>
| |
| </table>
| |
|
| |
|
| |
| <table border="0" cellpadding="0" cellspacing="2">
| |
| <tr><td colspan="4" align="center">'''amask:'''</td></tr>
| |
| <tr>
| |
| <td align="center">'''Byte 1'''</td>
| |
| <td align="center">'''Byte 2'''</td>
| |
| <td align="center">'''Byte 3'''</td>
| |
| <td align="center">'''Byte 4'''</td>
| |
| </tr>
| |
| <tr>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>int4 anime total episodes</td>
| |
| </tr>
| |
| <tr>
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>int4 highest episode number</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>str year</td>
| |
| </tr>
| |
| <tr>
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>str type</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>str related aid list</td>
| |
| </tr>
| |
| <tr>
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>str related aid type</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>str category list</td>
| |
| </tr>
| |
| <tr>
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>reserved</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr>
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>str romaji name</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>str kanji name</td>
| |
| </tr>
| |
| <tr>
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>str english name</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>str other name</td>
| |
| </tr>
| |
| <tr>
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>str short name list</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>str synonym list</td>
| |
| </tr>
| |
| <tr>
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>str producer name list</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>str producer id list</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>str epno</td>
| |
| </tr>
| |
| <tr>
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>str ep name</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>str ep romaji name</td>
| |
| </tr>
| |
| <tr>
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>str ep kanji name</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| <td>
| |
| <table>
| |
| <tr>
| |
| <td>'''Bit'''</td>
| |
| <td align="right">'''Dec'''</td>
| |
| <td>'''Data Field'''</td>
| |
| </tr>
| |
| <tr>
| |
| <td>7</td>
| |
| <td align="right">128</td>
| |
| <td>str group name</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>6</td>
| |
| <td align="right">64</td>
| |
| <td>str group short name</td>
| |
| </tr>
| |
| <tr>
| |
| <td>5</td>
| |
| <td align="right">32</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>4</td>
| |
| <td align="right">16</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>3</td>
| |
| <td align="right">8</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>2</td>
| |
| <td align="right">4</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr>
| |
| <td>1</td>
| |
| <td align="right">2</td>
| |
| <td>unused</td>
| |
| </tr>
| |
| <tr bgcolor="#eee">
| |
| <td>0</td>
| |
| <td align="right">1</td>
| |
| <td>reserved</td>
| |
| </tr>
| |
| </table>
| |
| </td>
| |
| </tr>
| |
| </table>
| |
|
| |
| ----
| |
FILE acode & fcode replacement
ANIME acode replacement
amask:
Byte 1 |
Byte 2 |
Byte 3 |
Byte 4 |
Byte 5 |
Bit |
Dec |
Data Field |
7 |
128 |
int aid |
6 |
64 |
unused |
5 |
32 |
str year |
4 |
16 |
str type |
3 |
8 |
str related aid list |
2 |
4 |
str related aid type |
1 |
2 |
str category list |
0 |
1 |
reserved |
|
Bit |
Dec |
Data Field |
7 |
128 |
str romaji name |
6 |
64 |
str kanji name |
5 |
32 |
str english name |
4 |
16 |
str other name |
3 |
8 |
str short name list |
2 |
4 |
str synonym list |
1 |
2 |
str producer name list |
0 |
1 |
str producer id list |
|
Bit |
Dec |
Data Field |
7 |
128 |
int4 episodes |
6 |
64 |
int4 normal ep count |
5 |
32 |
int4 special ep count |
4 |
16 |
int4 air date |
3 |
8 |
int4 end date |
2 |
4 |
str url |
1 |
2 |
str picname |
0 |
1 |
unused |
|
Bit |
Dec |
Data Field |
7 |
128 |
int4 rating |
6 |
64 |
int4 vote count |
5 |
32 |
int4 temp rating |
4 |
16 |
int4 temp vote count |
3 |
8 |
int4 average review rating |
2 |
4 |
int4 review count |
1 |
2 |
str award list |
0 |
1 |
unused |
|
Bit |
Dec |
Data Field |
7 |
128 |
int4 anime planet id |
6 |
64 |
int4 ANN id |
5 |
32 |
int4 allcinema id |
4 |
16 |
str animenfo id |
3 |
8 |
unused |
2 |
4 |
unused |
1 |
2 |
unused |
0 |
1 |
reserved |
|
ANIME Relationship Types
%adb_seq_subs::seq_type = (
1 => 'sequel',
2 => 'prequel',
11 => 'same setting',
12 => 'same setting',
21 => 'alternative setting',
22 => 'alternative setting',
31 => 'alternative version',
32 => 'alternative version',
41 => 'character',
42 => 'character',
51 => 'side story',
52 => 'parent story',
61 => 'summary',
62 => 'full story',
100 => 'other'
);
MYLISTEXPORT: Schedule a MyList Export
Queues a MyList Export by the AniDb Servers. As with a manual export request, exports are only done during periods when server load is low. As a result, exports may take up to 24 hours. The client submitting the request will receive an AniDb message when the export is ready to be collected.
Only one export can be in the queue at a time.
Command String:
- MYLISTEXPORT [template={str template_name}|cancel=1]
Possible Replies:
- 217 Export Queued
- 218 Export Cancelled
- 317 No Such Template
- 318 Export Already In Queue
- 319 No Export In Queue or Export In Progress
Info:
- template_name must match an available export template on the MyList Export page.
- cancel will cancel any pending export request, queued either through UDP or the web server.
- Clients can subscribe the message notifications if they wish to be notified when an export is complete.
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 |