mirror of
https://github.com/NotAShelf/catApi.git
synced 2024-11-01 15:01:13 +00:00
40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
# 🐾 catApi
|
|
|
|
> **catApi** is a minimal, self-hostable API endpoint for serving pictures of, you guessed it, cats!
|
|
> but it could be used to serve anything, really
|
|
|
|
## Usage
|
|
|
|
There are two ways to "use" **catApi** - you can either serve it, blessing the world with pictures of your cat
|
|
or be served. Below is the API documentation for visiting an existing instance of catApi.
|
|
|
|
### API Documentation
|
|
|
|
**catApi** exposes several endpoints.
|
|
|
|
#### ID
|
|
|
|
`/api/id` will return the image with the associated ID.
|
|
|
|
For example **`http://localhost:3000/api/id?id=3`** will return the image with the ID of "3".
|
|
|
|
#### List
|
|
|
|
`/api/list` will return eturn a JSON object containing data about the images within the /images directory
|
|
|
|
For example, **`http://localhost:3000/api/random`** will return a JSON object that might be as follows
|
|
|
|
> `[{"id":"0","url":"/api/id?id=0"},{"id":"1","url":"/api/id?id=1"},{"id":"2","url":"/api/id?id=2"}]`
|
|
|
|
#### Random
|
|
|
|
`/api/random` will return a random image from the list of available images
|
|
|
|
### Self-hosting
|
|
|
|
TODO
|
|
|
|
## License
|
|
|
|
> **catApi** is licensed under the [MIT](https://github.com/NotAShelf/catApi/blob/v2/LICENSE) license.
|