mirror of https://github.com/Decicus/DecAPI.git synced 2024-07-15 08:15:43 +02:00
Mirror of the main DecAPI repository (hosted on GitHub) https://decapi.me/
Go to file
2024-05-14 20:33:46 +02:00
.docker [IP Blacklist] Include reason in response, add env var for contact URL 2021-11-09 20:48:35 +01:00
.github [Dependencies] Update composer dependencies 2022-08-16 17:17:16 +00:00
app [Twitch] Auth - Refactor handling of expired tokens 2024-05-14 18:29:14 +00:00
bootstrap Update to Laravel 5.6 2018-03-25 03:44:09 +02:00
config [YouTube] Latest Video - Cache currently active livestreams for a shorter timeframe 2023-10-31 10:46:44 +00:00
database [Twitch] Begin migration of followage and followed 2023-10-01 00:18:12 +00:00
public [Twitch] Begin migration of followage and followed 2023-10-01 00:18:12 +00:00
resources [Twitch] Tweak auth handling for followage/followed, more caching 2023-10-01 16:26:46 +00:00
routes [Twitch] Begin migration of followage and followed 2023-10-01 00:18:12 +00:00
storage [Maintenance] Upgrade from Laravel 5.6 to 5.8 2019-04-23 22:09:41 +02:00
tests First commit 2016-02-07 13:37:48 -05:00
.dockerignore [Twitch] Subscriber Emotes - Fix wrong output format for 'tiers' param 2021-07-03 22:22:37 +02:00
.editorconfig [Docker] Add Dockerfile (image) and Docker Compose example file 2020-07-29 20:51:03 +02:00
.env.example [Twitter] Fully deprecate all endpoints 2023-09-30 18:34:23 +00:00
.gitattributes Line endings 2016-12-15 15:06:49 +01:00
.gitignore [Docker] Add Dockerfile (image) and Docker Compose example file 2020-07-29 20:51:03 +02:00
access.log Update RSS for Ask.fm 2016-02-14 00:59:07 +01:00
artisan First commit 2016-02-07 13:37:48 -05:00
composer.json [Maintenance] Upgrade to Laravel 9, remove some unnecessary dependencies, cleanup unnecessary code 2023-06-06 20:00:26 +00:00
composer.lock [Dependencies] Update dependencies 2024-05-13 18:55:15 +00:00
docker-compose.example.yml [Twitch] Subscriber Emotes - Fix wrong output format for 'tiers' param 2021-07-03 22:22:37 +02:00
Dockerfile Upgrade libraries/Dockerfile for PHP 8.1 2022-09-17 19:15:31 +00:00
error.log Update RSS for Ask.fm 2016-02-14 00:59:07 +01:00
fortrabbit.yml Possible fix for fortrabbit deployment 2017-04-01 01:07:26 +02:00
gulpfile.js First commit 2016-02-07 13:37:48 -05:00
LICENSE [LICENSE] Update LICENSE text/years (MIT) 2020-07-26 17:47:36 +02:00
package.json First commit 2016-02-07 13:37:48 -05:00
phpunit.xml First commit 2016-02-07 13:37:48 -05:00
ray.php [Development] Add support for Ray 2021-02-20 12:42:46 +01:00
readme.md [Twitter] Fully deprecate all endpoints 2023-09-30 18:34:23 +00:00
server.php First commit 2016-02-07 13:37:48 -05:00


What is DecAPI?

DecAPI started out as an API designed primarily for Twitch chatbots that supported sending requests to external APIs.
These chatbots would send requests to the APIs and then just return the response directly, which is the whole reason DecAPI mainly responds in plaintext.

While the primary usage of DecAPI is still related to Twitch chatbots, it's also used by other developers for stream overlays, websites etc.
Even though I generally allow everyone to rely on DecAPI for their data, I still recommend relying on the direct APIs whenever possible.

Development history

DecAPI is a personal project I started writing in 2014 (V1), which eventually became a big pile of undocumented, and badly written mess.

The current version of DecAPI (V2) was started in early 2016 and is an attempt to rewrite the codebase, while also keeping backwards compatibility, but also have it somewhat structured (unlike V1).
V2 is based on the Laravel framework.


The CONTRIBUTING document has been moved to .github/CONTRIBUTING.md


The layout of the application can be reflected upon by looking at the routes/web.php file. Each group uses their own controller located in app/Http/Controllers, and each sub-route usually has their own method in said controller.

The standard layout will be https://example.com/main-route/sub-route/parameter - where parameter can be something like the channel name.

To keep it backwards compatible, routes also support /main-route/sub-route?channel=decicus or /main-route/sub-route.php?channel=decicus.


The following things are required for setting this up:


I only recommend setting this up for development purposes.

  • Rename .env.example to .env and fill in the information in the .env file. Primarly the database and Twitch information.
    • If you are setting this up on a publicly accessible environment, make sure to set the APP_DEBUG value to false to not leak any credentials.
    • Twitch: You can create a Twitch application here: Twitch developer console - The redirect URL has to be http://your.url/auth/twitch/callback and TWITCH_REDIRECT_URI in the .env file has to be set to the same URL.
    • YouTube: Read the Getting Started page and Creating API keys section.
    • Papertrail: This is (optionally) used for external error logging. If you wish to use it, register on Papertrail and set the PAPERTRAIL_LOG_DESTINATION to whatever Papertrail gives you that's in the logsX.papertrailapp.com:YYYY format.
      • X and YYYY are numbers, and are just placeholders.
    • Steam: You can obtain a Steam API key here: Steam API Developer Portal
  • Run composer install in the project directory.
  • Run php artisan key:generate from the command line in the base project directory, to generate the application key.
  • Run php artisan migrate from the command line in the base project directory.
  • Point your web server to the /public directory of the repo.
    • I recommend using apache2 and configuring it to set AllowOverride to All for the specific directory in the vhost, so the .htaccess file can set the settings.
  • Setup the task scheduler by pointing a cron entry to * * * * * php /path/to/decapi/artisan schedule:run >> /dev/null 2>&1.
    • You can see what commands the scheduler runs in app/Console/Kernel.php.


Documentation is currently work in progress and can be found here:

Bugs & reports

If you find a bug or an issue, please create an issue in this repository.

If it's a security issue and you'd like to contact me privately, please send me an email at alex@thomassen.xyz.

Rate limits

Certain routes may have rate limiting applied to them to prevent abuse or to make sure DecAPI doesn't get blocked by the API provider.
The rate limits are set to something I consider "fair". Which primarily means they are set to something that should not hinder the normal user, but also should not allow them to go spam requests for no good reason.

Rate limiting is done by using Laravel's throttle middleware. This means you can check HTTP headers sent with the request to figure out information about your rate-limit:

  • X-RateLimit-Limit - How many requests per 1 minute (60 seconds) is allowed.
  • X-RateLimit-Remaining - How many requests you have left for this time period.
  • Retry-After - How many seconds until you can make requests again (Only when you have actually hit your rate limit).
    • Another note: If you have hit your rate limit, you will receive a 429 Too many requests HTTP status code.

Below is an overview over what routes are currently rate limited. If the route is not specified, it does not have a rate limit.

Rate limits per route are separate from each other.
If you've sent 45 requests to /steam routes, you will still have the ability to send another 100 requests to /twitch routes.

  • /twitch/* - All sub-routes under /twitch
    • Limit: 100 requests per 60 seconds.
  • /steam/* - All sub-routes under /steam
    • Limit: 15 requests per 60 seconds.


MIT License

Special thanks to

  • xgerhard - For implementing the /twitch/subage & /twitch/latest_sub routes.