Arm Server Versions Save

📃 A service for mapping Anime IDs between Database Websites

2023-01-04

1 year ago

/api/v2/*

All endpoints under /v2 have a new query parameter: include

It's a comma-separated list of Sources to return from the database, if you want to save a teeny amount of bandwidth.

e.g. include=anilist,anidb,kitsu

GET/POST /api/v2/ids

Works just like before, except:

  • Can query with and get back the new Sources
  • Except for querying with thetvdb - see below for more details

GET /api/v2/thetvdb?id={number}

This endpoint exists for one reason: TheTVDB stores entire shows as entries instead of the usual seasons that all anime sites use.

This means that many TheTVDB ID maps to multiple IDs in for other services, for example thetvdb:70799 (Beyblade) has 8(!) entries in other sites.

The one-to-many relation would break the old API endpoint, so you'll have to use this one if you want to query by thetvdb.

The new sources are:

  • Anime-Planet (anime-planet)
  • aniSearch (anisearch)
  • IMDB (imdb)
  • LiveChart (livechart)
  • notify.moe (notify-moe)
  • TheMovieDB (themoviedb)
  • TheTVDB (thetvdb)

2021-06-09

2 years ago

Refactored the server to use Fastify rather than Koa.

There should have been no breaking changes if you're using the service as the API describes it.

Let me know if anything is bonkers!

2020-06-02

2 years ago

Invalid HTTP requests have been deprecated.

They will have a 33% chance to respond with a 400, with a message detailing this deprecation.

i.e:

  • Sending JSON bodies in GET requests
  • Sending query parameters in POST requests