52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
|
title: API
|
||
|
|
|
||
|
|
## Authentication
|
||
|
|
|
||
|
|
Not all endpoints require authentication.
|
||
|
|
Authentication is done using Bearer tokens:
|
||
|
|
|
||
|
|
Authorization: Bearer YOURTOKEN
|
||
|
|
|
||
|
|
You can use the `/api/whoami` to check authentication.
|
||
|
|
|
||
|
|
## Endpoints
|
||
|
|
|
||
|
|
### Misc
|
||
|
|
|
||
|
|
* GET `/api/whoami/` - Json dictionary with the following keys:
|
||
|
|
* `is_authenticated` - True on successful API authentication
|
||
|
|
* `username` - Username of the user authenticated as, null otherwise.
|
||
|
|
* 403 will be thrown on unsupported authentication type, invalid access token, or other errors.
|
||
|
|
|
||
|
|
### Packages
|
||
|
|
|
||
|
|
* GET `/api/packages/` - See [Package Queries](#package-queries)
|
||
|
|
* GET `/api/packages/<username>/<name>/`
|
||
|
|
|
||
|
|
### Topics
|
||
|
|
|
||
|
|
* GET `/api/topics/` - Supports [Package Queries](#package-queries), and the following two options:
|
||
|
|
* `show_added` - Show topics which exist as packages, default true.
|
||
|
|
* `show_discarded` - Show topics which have been marked as outdated, default false.
|
||
|
|
|
||
|
|
### Minetest
|
||
|
|
|
||
|
|
* GET `/api/minetest_versions/`
|
||
|
|
|
||
|
|
|
||
|
|
## Package Queries
|
||
|
|
|
||
|
|
Example:
|
||
|
|
|
||
|
|
/api/packages/?type=mod&type=game&q=mobs+fun&hide=nonfree&hide=gore
|
||
|
|
|
||
|
|
Supported query parameters:
|
||
|
|
|
||
|
|
* `type` - Package types (`mod`, `game`, `txp`).
|
||
|
|
* `q` - Query string
|
||
|
|
* `random` - When present, enable random ordering and ignore `sort`.
|
||
|
|
* `hide` - Hide content based on [Content Flags](content_flags).
|
||
|
|
* `sort` - Sort by (`name`, `views`, `date`, `score`).
|
||
|
|
* `order` - Sort ascending (`Asc`) or descending (`desc`).
|
||
|
|
* `protocol_version` - Only show packages supported by this Minetest protocol version.
|