Difference between revisions of "API Access"
Jump to navigation
Jump to search
(→Second, you need to rate limit your requests.: Got rid of nginx stuff) |
(Added information and changed some wording.) |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
==How Not To Get Banned== | ==How Not To Get Banned== | ||
| − | ===First | + | ===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. | 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 | + | To safely check your user agent, visit this page: |
| + | https://www.animecharactersdatabase.com/vars.php | ||
| − | ===Second | + | ===Second: Rate limit your requests.=== |
Respectfully, limit your bot to 1 request per second. | 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== | ==Changes== | ||
January 20th 2021 | January 20th 2021 | ||
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
