Difference between revisions of "API Access"

From Anime Characters Database Wiki
Jump to navigation Jump to search
Line 3: Line 3:
 
  [http://www.animecharactersdatabase.com/api_series_characters.php Current API Tools]
 
  [http://www.animecharactersdatabase.com/api_series_characters.php Current API Tools]
  
How Not To Get Banned
+
==How Not To Get Banned==
  
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.===
  
 
  Using the wrong user agent will ban your IP for the day ( 402 Payment Required )
 
  Using the wrong user agent will ban your IP for the day ( 402 Payment Required )
Line 13: Line 13:
 
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, you need to rate limit your requests.
+
===Second, you need to rate limit your requests.===
  
 
  30 pages in 3 seconds will trigger a DoS ban. ( 429 Too Many Requests )
 
  30 pages in 3 seconds will trigger a DoS ban. ( 429 Too Many Requests )
 
  100 pages in 100 seconds will trigger a day ban ( 503 Service Unavailable )
 
  100 pages in 100 seconds will trigger a day ban ( 503 Service Unavailable )
 
  3000 pages in day will trigger a day ban ( 503 Service Unavailable )
 
  3000 pages in day will trigger a day ban ( 503 Service Unavailable )

Revision as of 04:35, 20 March 2019

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.

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.

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 alos left it default, and together may pose a DDoS threat. This is why I auto ban curl/python/wget.

To safely check your user agent, visit this page: https://www.animecharactersdatabase.com/vars.php

Second, you need to rate limit your requests.

30 pages in 3 seconds will trigger a DoS ban. ( 429 Too Many Requests )
100 pages in 100 seconds will trigger a day ban ( 503 Service Unavailable )
3000 pages in day will trigger a day ban ( 503 Service Unavailable )