Editing API Access

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
 
+
Do you have a project that could benefit from the data on Anime Characters Database? As a way to help pay the server bills, I offer my services to develop a custom API to suit for your needs for a small fee.
  
 
  [http://www.animecharactersdatabase.com/api_series_characters.php Current API Tools]
 
  [http://www.animecharactersdatabase.com/api_series_characters.php Current API Tools]
Line 7: Line 7:
 
===First, you need to set a HTTP_USER_AGENT for the tool you will be accessing ACDB from.===
 
===First, you need to set a HTTP_USER_AGENT for the tool you will be accessing ACDB from.===
  
  You will get errors like ( 402 Payment Required ) if Python,Perl,etc is in your user agent.
+
  Using the wrong user agent will ban your IP for the day ( 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.
Line 14: Line 14:
  
 
===Second, you need to rate limit your requests.===
 
===Second, you need to rate limit your requests.===
Respectfully, limit your bot to 1 request per second.
 
 
Our nginx.conf limits as of January 20th 2021 are:
 
limit_req_zone $binary_remote_addr zone=one:10m rate=5r/s;
 
limit_req_zone $server_name zone=fast:10m rate=90r/s;
 
limit_req zone=one burst=10;
 
limit_req zone=fast burst=200;
 
  
==Changes==
+
30 pages in 3 seconds will trigger a DoS ban. ( 429 Too Many Requests )
  January 20th 2021
+
  100 pages in 100 seconds will trigger a day ban ( 503 Service Unavailable )
When requesting birthdays
+
3000 pages in day will trigger a day ban ( 503 Service Unavailable )
*character_image now returns the full sized character image
 
*character_thumb has been added to return the character thumb instead
 

Please note that all contributions to Anime Characters Database Wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Anime Characters Database Wiki:Copyrights for details). Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)