aboutsummaryrefslogtreecommitdiff
path: root/api.md
blob: a8a229eb8299804a17946e0bb7045486e18a6908 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Jellything API

Routes marked with `*` require authentification. Any endpoint returning JSON,
will report errors with an object containing error string in the `error` key.

The `jellycommon` crate provides useful structs for deserializing data.

```toml
# Cargo.toml
[depedencies]
jellycommon = { git = "https://codeberg.org/metamuffin/jellything.git" }
```

## GET `/api/version`

Returns API version number.

## POST `/api/account/login`

Request body contains JSON with keys `username` and `password`. The Response
contains the session cookie.

## GET* `/api/library/<path...>`

Request a library node (either a directory or item). See
[`common/src/api.rs`](./common/src/api.rs)