Miscellaneous other API

Other APIs that don't fit a dedicated theme.

Get server info

get

Returns some basic information about the LRR instance this server is running.

Responses

200

Server info

application/json

get

/info

HTTPcURLJavaScriptPython

GET /api/info HTTP/1.1
Host: lrr.tvc-16.science
Accept: */*

200

Server info

{
  "archives_per_page": 100,
  "cache_last_cleared": 1728852701,
  "debug_mode": true,
  "has_password": false,
  "name": "LANraragi",
  "motd": "aye lads time to read some manga",
  "nofun_mode": false,
  "server_resizes_images": false,
  "server_tracks_progress": true,
  "total_archives": 104,
  "total_pages_read": 252,
  "version": "0.9.30",
  "version_desc": "I'm under Japanese influence and my honor's at stake!",
  "version_name": "Law (Earthlings On Fire)"
}

Clean the Temporary Folder

delete

Cleans the server's temporary folder.

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Responses

200

Cleanup result

application/json

delete

/tempfolder

HTTPcURLJavaScriptPython

DELETE /api/tempfolder HTTP/1.1
Host: lrr.tvc-16.science
Authorization: YOUR_API_KEY
Accept: */*

200

Cleanup result

{
  "operation": "cleantemp",
  "error": null,
  "newsize": 0,
  "success": 1
}

Queue a URL download

post

Add a URL to be downloaded by the server and added to its library.

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Query parameters

urlstring · uriRequired

URL to download

catidstring · min: 14 · max: 14Optional

Category ID to add the downloaded URL to.

Responses

200

Enqueued job

application/json

400

Bad request

application/json

post

/download_url

HTTPcURLJavaScriptPython

POST /api/download_url?url=https%3A%2F%2Fexample.com HTTP/1.1
Host: lrr.tvc-16.science
Authorization: YOUR_API_KEY
Accept: */*

{
  "job": 86,
  "operation": "download_url",
  "success": 1,
  "url": "https://example.com"
}

Regenerate Thumbnails

post

Queue a Minion job to regenerate missing/all thumbnails on the server.

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Query parameters

forcebooleanOptional

Whether to generate all thumbnails, or only the missing ones.

Responses

200

Enqueued job

application/json

post

/regen_thumbs

HTTPcURLJavaScriptPython

POST /api/regen_thumbs HTTP/1.1
Host: lrr.tvc-16.science
Authorization: YOUR_API_KEY
Accept: */*

200

Enqueued job

{
  "job": 3,
  "operation": "regen_thumbnails",
  "success": 1
}