Database API

Query and modify the database.

Get Statistics

get

Get tags from the database, with a value symbolizing their prevalence.

Query parameters

minweightintegerOptional

Add this parameter if you want to only get tags whose weight is at least the given minimum.
Default is 1 if not specified, to get all tags.

Responses

200

Success response

application/json

get

/database/stats

HTTPcURLJavaScriptPython

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

200

Success response

[
  {
    "namespace": "character",
    "text": "jeanne alter",
    "weight": 2
  },
  {
    "namespace": "character",
    "text": "xuanzang",
    "weight": 2
  },
  {
    "namespace": "parody",
    "text": "fate grand order",
    "weight": 3
  },
  {
    "namespace": null,
    "text": "artbook",
    "weight": 3
  }
]

🔑 Get a backup JSON

get

Scans the entire database and returns a backup in JSON form. This backup can be reimported manually through the Backup and Restore feature.

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Responses

200

Success response

application/json

get

/database/backup

HTTPcURLJavaScriptPython

GET /api/database/backup HTTP/1.1
Host: lrr.tvc-16.science
Authorization: YOUR_API_KEY
Accept: */*

200

Success response

{
  "archives": [
    {
      "arcid": "28697b96f0ac5858be2614ed10ca47742c9522fd",
      "title": "Fate GO MEMO",
      "tags": "parody:fate grand order, group:wadamemo, artist:wada rco, artbook, full color, super:test, date_added:1553537258",
      "summary": null,
      "thumbhash": "ec2a0ca3a3da67a9390889f0910fe494241faa9a",
      "filename": "FateGOMEMO"
    },
    {
      "arcid": "d1858d5dc36925aa66be072a97817650d39de166",
      "title": "test title",
      "tags": null,
      "summary": null,
      "thumbhash": "9846bb6d62949b56545c42e88d8010446b65702e",
      "filename": "(Memes)9B789D38B0784C5FBC9D59A9F24D20F2"
    }
  ],
  "categories": [
    {
      "archives": [],
      "catid": "SET_1749925633",
      "name": "english",
      "search": "language:english"
    }
  ],
  "tankoubons": [
    {
      "tankid": "TANK_1749925516",
      "name": "sailor moon",
      "archives": [
        "28697b96f0ac5858be2614ed10ca47742c9522fd",
        "d1858d5dc36925aa66be072a97817650d39de166"
      ]
    }
  ]
}

🔑 Clear All "New" flags

delete

Clears the "New!" flag on all archives.

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Responses

200

Success response

application/json

delete

/database/isnew

HTTPcURLJavaScriptPython

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

200

Success response

{
  "operation": "text",
  "error": "text",
  "successMessage": "text",
  "success": 0
}

🔑 Clean the Database

post

Cleans the Database, hiding then removing entries for files that are no longer on the filesystem. Entries that are no longer on the filesystem are only unlinked at first so they don't appear in the UI -- A subsequent run of this cleanup will delete unlinked entries.

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Responses

200

Success response

application/json

post

/database/clean

HTTPcURLJavaScriptPython

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

200

Success response

{
  "operation": "text",
  "success": 0,
  "deleted": 1,
  "unlinked": 1
}

🔑 Drop the Database

post

Delete the entire database, including user preferences. This is a rather dangerous endpoint, invoking it might lock you out of the server as a client!

Authorizations

api_key

AuthorizationstringRequired

Use Authorization: Bearer <base64(api_key)>

Responses

200

Success response

application/json

post

/database/drop

HTTPcURLJavaScriptPython

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

200

Success response

{
  "operation": "text",
  "error": "text",
  "successMessage": "text",
  "success": 0
}