Skip to content

NotAShelf/catApi

Repository files navigation

🐾 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 license.

About

A scuffed website to display random pictures of random cats of people who contribute to it. No NFTs... yet.

Topics

Resources

License

Stars

Watchers

Forks