aboutsummaryrefslogtreecommitdiff
path: root/api.md
blob: 91cb3e304f9e3bfa564a87da7f9635976e6885f2 (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
27
28
29
30
# 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)

## GET* `/stream/<path..>?tracks=<track-ids>&webm=<bool>`

Responds with the stream.