Difference between revisions of "API Access"
Jump to navigation
Jump to search
(Added information and changed some wording.) |
|||
| (10 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | ==How Not To Get Banned== | |
| − | + | ===First: Set a HTTP_USER_AGENT for the tool you will be accessing ACDB from.=== | |
| − | + | If Python,Perl,etc is in your user agent, you will get errors like | |
| + | ( 402 Payment Required ) | ||
| + | If you leave it with the default, you will be joining a pool of people who also left it default, and together may pose a DDoS threat. This is why I auto ban curl/python/wget any any other popular tool. | ||
| − | + | To safely check your user agent, visit this page: | |
| + | https://www.animecharactersdatabase.com/vars.php | ||
| − | + | ===Second: Rate limit your requests.=== | |
| + | Respectfully, limit your bot to 1 request per second. | ||
| − | + | ==Current API tools== | |
| − | + | [http://www.animecharactersdatabase.com/api_series_characters.php Current API Tools] | |
| − | + | ==Characters== | |
| − | + | [https://www.animecharactersdatabase.com/hosted/characters.sql.gz Characters API] | |
| − | + | ==Titles== | |
| − | + | [https://www.animecharactersdatabase.com/hosted/publishers.sql.gz Titles API] | |
| − | + | ==Assignments== | |
| − | + | [https://www.animecharactersdatabase.com/hosted/assignments.sql.gz Assignments API] | |
| − | + | ==License== | |
| + | [https://opendatacommons.org/licenses/odbl/summary/index.html Open Database License - Terms of Legal Use] | ||
| + | ==Changes== | ||
| + | January 20th 2021 | ||
| + | When requesting birthdays | ||
| + | *character_image now returns the full sized character image | ||
| + | *character_thumb has been added to return the character thumb instead | ||
Latest revision as of 20:31, 20 July 2024
Contents
How Not To Get Banned[edit]
First: Set a HTTP_USER_AGENT for the tool you will be accessing ACDB from.[edit]
If Python,Perl,etc is in your user agent, you will get errors like
( 402 Payment Required )
If you leave it with the default, you will be joining a pool of people who also left it default, and together may pose a DDoS threat. This is why I auto ban curl/python/wget any any other popular tool.
To safely check your user agent, visit this page:
https://www.animecharactersdatabase.com/vars.php
Second: Rate limit your requests.[edit]
Respectfully, limit your bot to 1 request per second.
Current API tools[edit]
Current API Tools
Characters[edit]
Titles[edit]
Assignments[edit]
License[edit]
Open Database License - Terms of Legal Use
Changes[edit]
January 20th 2021
When requesting birthdays
- character_image now returns the full sized character image
- character_thumb has been added to return the character thumb instead
