21 lines
1 KiB
Markdown
21 lines
1 KiB
Markdown
|
# developer API
|
||
|
|
|
||
|
|
the API is meant for developers to access and use, it doesn't return human
|
||
|
|
readable data unlike the human interface
|
||
|
|
|
||
|
|
the POST APIs are based on form data requests and JSON responses
|
||
|
|
|
||
|
|
- `GET /api/image/<id>` - get image information
|
||
|
|
- `GET /api/search/<id>?q=...` - search in image descriptions, creation dates, and editing dates
|
||
|
|
- `POST /api/key` - check if you can access the key api ( admin access only )
|
||
|
|
- `POST /api/key/new` - generate a new access key, following form arguments are required :
|
||
|
|
- `perm` - the permission level, usually either `write` or `admin`
|
||
|
|
- `POST /api/key/revoke` - revoke a key
|
||
|
|
- `rev` form argument is required with the value of the key being revoked
|
||
|
|
- `GET /api/key/keys` - list all keys and their permission levels
|
||
|
|
- `GET /api/key/info` - shows information about a specific key
|
||
|
|
- `target` - the target key
|
||
|
|
|
||
|
|
keep in mind, this is **form data**, so in for example JavaScript you'd use `FormData`, or `-F'field=value'` in curl
|
||
|
|
and whatnot
|