Difference between revisions of "API Access"

From Anime Characters Database Wiki
Jump to navigation Jump to search
(Second, you need to rate limit your requests.)
(Second, you need to rate limit your requests.)
Line 15: Line 15:
  
 
===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.
  
NGINX handles rate limiting. 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 $binary_remote_addr zone=one:10m rate=5r/s;
    limit_req_zone $server_name zone=fast:10m rate=90r/s;
+
limit_req_zone $server_name zone=fast:10m rate=90r/s;
            limit_req zone=one burst=10;
+
limit_req zone=one burst=10;
            limit_req zone=fast burst=200;
+
limit_req zone=fast burst=200;

Revision as of 14:46, 20 January 2021

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. Contact Rei for more info.

Current API Tools

How Not To Get Banned

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.

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, 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;