Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/httpcats/http.cat

:cat: HTTP Cats API
https://github.com/httpcats/http.cat

api cats codes http httpcats httpstatuscats status

Last synced: about 2 months ago
JSON representation

:cat: HTTP Cats API

Host: GitHub
URL: https://github.com/httpcats/http.cat
Owner: httpcats
License: mit
Created: 2015-08-30T18:34:34.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2024-07-19T15:51:13.000Z (2 months ago)
Last Synced: 2024-07-19T20:37:24.057Z (2 months ago)
Topics: api, cats, codes, http, httpcats, httpstatuscats, status
Language: TypeScript
Homepage: https://http.cat
Size: 15.2 MB
Stars: 2,836
Watchers: 25
Forks: 157
Open Issues: 28
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-hilarious-repos - http cats api - You can use cats instead of HTTP errors (Standalone projects)
awesome - httpcats/http.cat - :cat: HTTP Cats API (TypeScript)

README

        # http.cat [![Build Status](https://travis-ci.com/httpcats/http.cat.svg?branch=master)](https://travis-ci.com/httpcats/http.cat)

![HTTP Cat picture](https://http.cat/204)

## About

This is the website that is hosted at [https://http.cat](https://http.cat).

The code for the older version hosted at the heroku platform is at the [http-status-cats-api](https://github.com/rogeriopvl/http-status-cats-api) repo.

This version does not need any server side code. The API behavior is provided by a Nginx server config.

On v2.0.0 the website was built with React and pre-rendered with react-snap.

As of v3.0.0 it's built with Next.js 13.

## Development

    npm run dev

Starts the development server.

    npm test

Runs the tests.

    npm run build

Creates a build of the project.

## Adding a new image

Currently not all HTTP status codes are covered. You are welcome to create an issue or PR to cover them.

We've prepared some templates to make this process easier.

- [Landscape template](https://docs.google.com/presentation/d/1sYxNNKxUbP11kyt9oPixWdFEykHDafr4jixy9uwMh9I/edit?usp=sharing)

- [Portrait template](https://docs.google.com/presentation/d/1Ay5nattHagPfnd-gMaUHumckFt2VANaYwMkXuQ-xS6E/edit?usp=sharing)

You can clone it, replace the information with the new one and export as a JPG image.

Then, upload it to both `public/images` and `public/images-original` folders and update the [statuses.js](https://github.com/httpcats/http.cat/blob/master/lib/statuses.js) file.

## Credits

Thanks to [@girliemac](https://github.com/girliemac) for creating the amazing http status cats images.

Thanks to [@pfdborges](https://github.com/pfdborges) for creating the http.cat logo (RIP my friend).

#### Thanks to all the contributors:

  

    

      
_{John HU}
🔣 ️️️️♿️

      
_{Tomomi ❤ Imura}
💻 🖋 🌍

      
_{strangeloveBsc}
💻 🎨

      
_{Nátaly Enne}
💻

      
_{Lennart Blom}
💻

      
_BitterPanda
💻

      
_{Katrin Leinweber}
💻

    

    

      
_{Luiz Fernando da Silva Cieslak}
💻

      
_{Leonard Janis Robert König}
💻

      
_{Omar Flores Grimontt}
💻

      
_Kian
💻

      
_{David Cruz}
💻 🎨 ️️️️♿️

      
_{Matt Lavoie}
💻

      
_zurgeg
💻

    

    

      
_Joshix-1
💻

      
_kiriya-aoi
💻

      
_{Jasmin Lapointe}
💻

      
_Arnau
🌍

      
_{Mathias Oterhals Myklebust}
💻

      
_Ronan
💻

      
_{Alejandro Mayol}
🎨 💻

    

    

      
_NoobTracker
💻

      
_{Mohammad Kazemi}
📖

      
_{Lucas Mezêncio}
💻

      
_Xeno
💻

      
_{Santiago Salinas}
🖋

      
_{Karl Hiramoto}
💻

    

  

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=httpcats/http.cat&type=Date)](https://star-history.com/#httpcats/http.cat&Date)

## Sponsor / Donate

Please consider sponsoring or donating via the following options:

 

You can also adopt an HTTP Cat and have your name in the chosen cat image!

## License

MIT