Skip to content

A UI Based interface to guide you to exact web api - http specification status your server should return for any request.

License

Notifications You must be signed in to change notification settings

anubhavsrivastava/whats-my-http-statuscode

Repository files navigation

Whats my HTTP Status Code - Visit

A UI Based interface to guide you to exact web api - http specification status your server should return for any web request.

Build Status Coverage Status PRs Welcome GitHub issues HitCount

Introduction

This projects helps you choose appropriate HTTP status code for your web APIs. Based on series of questions, it lets arrive to a appropriate HTTP status code (with reason). In short, it makes choosing HTTP code much easier.

Concepts

Usage

Answer a series of question regarding your current implementation or problem that you have with the API, starting off with selection of HTTP code series, like 200 series (success) or 500 series (server error). Once you have correctly identified you HTTP status series, you can answer few more questions to get to exact HTTP status code.

Why should any developer use it?

There can be a confusion regarding what exact HTTP status code should be for a particular scenario, for eg, should it be 404 Not Found or 204 No Content in scenarios where resource exist but has no information. Or should one give 403 Forbidden for access denied resource and let the user know about existence of the resource (security) or should say 404 Not Found.

For whom is this tool meant for?

This is meant for Restful APIs and system that want to follow standard HTTP status code. One should consider following a specification for better usability across system, providing APIs to third party, disconnecting WEB API server with frontend to understand API response, or simply move ahead with just 200 OK status across the system with actual reason in body { "status": "failure" }

Inspiration

Inspired by the awesome work on HTTP status code selection by Michael Kropat - Codetinkerer.com

Development

To add more features or fix a thing or two, to this project, you need to make sure you have all the requirements checked, this project installed, and a little understanding of this project.

Requirement

You need to be at least familiar with the following tools and languages:

  • HTML/CSS 3/JavaScript
  • React/Redux/React-Router
  • JSON

Installation

You can now install the project and start developing. To do so, just follow these steps:

  • Fork this project.
  • Clone your fork git clone
  • Branch out git branch -b NEW-BRANCH
  • Make your changes.
  • Create a pull request.

To run this project locally, perform following steps

  • Install packages via npm install or yarn , this will install all the dependencies required by the project
  • To start development on local machine, run npm start on terminal.

P.S This project is created from ejected create-react-app.

Contribution

One can contribute to this project in following ways,

Development

This project can be improved so much more, with new features and design. Code refactoring is also welcomed. If you are willing and interested, feel free to help develop it for yourself and others.

Report issues and help improve

If you feel a feature is missing, or you have encounter a bug, report it in the issues section. Even if you feel question/flow are leading to wrong interpretation, feel free to open a issue. Please read the contribution guidelines to get started.

Spread the words

⭐️ Star this project, use it, or share it with your friends. It will really help us to gain motivation and zeal towards working on it.

License

Open Source Love

Refer LICENSE file in this repository.