|
|
|
@@ -26,7 +26,6 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [Testing](#testing)
|
|
|
|
|
* [Querying](#querying)
|
|
|
|
|
* [Mocking](#mocking)
|
|
|
|
|
* [Debugging Proxies](#debugging-proxies)
|
|
|
|
|
* [Public REST APIs To Use In Tests](#public-rest-apis-to-use-in-tests)
|
|
|
|
|
* [Documentation](#documentation)
|
|
|
|
|
* [API Gateway](#api-gateway)
|
|
|
|
@@ -37,7 +36,8 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
|
|
|
|
|
## Design
|
|
|
|
|
|
|
|
|
|
* [Architectural Styles and the Design of Network-based Software Architectures](https://roy.gbiv.com/pubs/dissertation/top.htm) - Roy Fielding's dissertation defining REST
|
|
|
|
|
* [Architectural Styles and
|
|
|
|
|
the Design of Network-based Software Architectures](https://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm) - Roy Fielding's dissertation defining REST
|
|
|
|
|
* [HTTP API design guide extracted from work on the Heroku Platform API](https://github.com/interagent/http-api-design)
|
|
|
|
|
* [Best Practices for Designing a Pragmatic RESTful API](https://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api)
|
|
|
|
|
* [How to design a REST API?](https://blog.octo.com/en/design-a-rest-api/) - Full guide tackling security, pagination, filtering, versioning, partial answers, CORS, etc.
|
|
|
|
@@ -47,6 +47,7 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [How to GET a cup of coffee](https://www.infoq.com/articles/webber-rest-workflow/)
|
|
|
|
|
* [REST API Tutorial](https://www.restapitutorial.com/) - RestApiTutorial.com is dedicated to tracking REST API best practices and making resources available to enable quick reference and self education for the development crafts-person.
|
|
|
|
|
* [API-Security-Checklist](https://github.com/shieldfy/API-Security-Checklist) - Best practices about REST API security
|
|
|
|
|
* [Mastering REST APIs in Node.js: Zero-To-Hero](https://www.manning.com/livevideo/mastering-rest-apis-in-nodejs) - Video course about how REST APIs work, how to create them, and how to keep them secure.
|
|
|
|
|
|
|
|
|
|
### Guidelines
|
|
|
|
|
|
|
|
|
@@ -55,7 +56,7 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [Cisco REST API Guide](https://github.com/CiscoDevNet/api-design-guide) - Guidelines for designing REST APIs at Cisco.
|
|
|
|
|
* [Google Cloud API design guide](https://cloud.google.com/apis/design/) - Guidelines Google follows when designing Cloud APIs and other Google APIs (REST APIs and gRPC APIs).
|
|
|
|
|
* [Haufe API Style Guide](https://github.com/Haufe-Lexware/api-style-guide) - Guidelines created by Haufe-Lexware CTO team.
|
|
|
|
|
* [Microsoft REST API Guidelines](https://github.com/microsoft/api-guidelines/blob/vNext/graph/GuidelinesGraph.md) - The Microsoft REST API Guidelines, as a design principle, encourages application developers to have resources accessible to them via a RESTful HTTP interface.
|
|
|
|
|
* [Microsoft REST API Guidelines](https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#readme) - The Microsoft REST API Guidelines, as a design principle, encourages application developers to have resources accessible to them via a RESTful HTTP interface.
|
|
|
|
|
* [Restful API Guidelines by Zalando](https://github.com/zalando/restful-api-guidelines) - Developing Restful APIs: A Comprehensive Set of Guidelines.
|
|
|
|
|
|
|
|
|
|
## Standards
|
|
|
|
@@ -131,6 +132,7 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [node-restify](https://github.com/restify/node-restify) - Framework specifically meant for REST API.
|
|
|
|
|
* [Sails.js](https://sailsjs.org/) - Node.js Web framework embedding a command to generate automatically a REST API.
|
|
|
|
|
* [mers](https://github.com/jspears/mers) - Express service exposing Mongoose finders as RESTful API.
|
|
|
|
|
* [Baucis](https://git.kun.io/wprl/baucis) - Build scalable REST API based on your Mongoose entities.
|
|
|
|
|
* [flatiron/resourceful](https://github.com/flatiron/resourceful) - Isomorphic Resource engine for JavaScript.
|
|
|
|
|
* [loopback](https://loopback.io/) - Powerful Node.js framework for creating APIs and easily connecting to backend data sources.
|
|
|
|
|
* [Feathers](https://feathersjs.com/) - is a real-time, micro-service web framework that gives you control over your data via RESTful resources, sockets and flexible plug-ins.
|
|
|
|
@@ -155,6 +157,7 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [REST APIs with Symfony2: the Right Way](https://williamdurand.fr/2012/08/02/rest-apis-with-symfony2-the-right-way/) - Complete guide to build a state-of-the-art REST API with Symfony2 framework.
|
|
|
|
|
* [FOSRestBundle](https://github.com/FriendsOfSymfony/FOSRestBundle) - Bundle handling view, routing, error handling, etc. for your REST API.
|
|
|
|
|
* [stanlemon/rest-bundle](https://github.com/stanlemon/rest-bundle) - Build a REST API based on Doctrine entities using conventions over configuration.
|
|
|
|
|
* [lakion/Lionframe](http://lakion.com/lionframe) - Glu between several community libraries to ease API development.
|
|
|
|
|
* [BazingaHateoasBundle](https://github.com/willdurand/BazingaHateoasBundle) - Integrate the [Hateoas](https://github.com/willdurand/Hateoas) library into a Symfony2 application.
|
|
|
|
|
* [Symfony REST Edition](https://github.com/gimler/symfony-rest-edition) - Start with a Symfony2 application with all REST-friendly bundles pre-configured.
|
|
|
|
|
* [NgAdminGeneratorBundle](https://github.com/marmelab/NgAdminGeneratorBundle) - Boostrap ng-admin configuration based on `stanlemon/rest-bundle`.
|
|
|
|
@@ -180,7 +183,6 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [apistar](https://github.com/encode/apistar) - A smart Web API framework, designed for Python 3.
|
|
|
|
|
* [Falcon](https://github.com/falconry/falcon) - Falcon is a bare-metal Python web API framework for building high-performance microservices, app backends, and higher-level frameworks.
|
|
|
|
|
* [FastAPI](https://github.com/tiangolo/fastapi) - FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints. With automatic API documentation using Swagger UI and ReDoc, based on OpenAPI and JSON Schema.
|
|
|
|
|
* [Zato](https://github.com/zatosource/zato/) - Platform for building server-side integrations, automations and API backends in Python.
|
|
|
|
|
|
|
|
|
|
### Ruby
|
|
|
|
|
|
|
|
|
@@ -196,6 +198,7 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [go-relax](https://github.com/codehack/go-relax) - Framework of pluggable components to build RESTful API's.
|
|
|
|
|
* [go-rest](https://github.com/ungerik/go-rest) - Small and evil REST framework for Go.
|
|
|
|
|
* [go-restful](https://github.com/emicklei/go-restful) - A declarative highly readable framework for building restful API's.
|
|
|
|
|
* [Goat](https://github.com/bahlo/goat) - Minimalistic REST API server in Go.
|
|
|
|
|
* [Resoursea](https://github.com/resoursea/api) - REST framework for quickly writing resource based services.
|
|
|
|
|
|
|
|
|
|
### Java
|
|
|
|
@@ -230,28 +233,19 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [Schemathesis](https://github.com/schemathesis/schemathesis) - Property-based testing tool for web applications built with Open API and GraphQL specifications.
|
|
|
|
|
* [Step CI](https://github.com/stepci/stepci) - Open-source framework for API Quality Assurance, which tests REST, GraphQL and gRPC automated and from Open API spec.
|
|
|
|
|
* [RestQA](https://github.com/restqa/restqa) - A REST API testing Framework based on BDD / Gherkin to manage microservice local testing.
|
|
|
|
|
* [Postman](https://www.postman.com/) - Cross-platform API development and testing platform.
|
|
|
|
|
* [SoapUI](https://www.soapui.org/) - Cross-platform API testing tool for REST and SOAP APIs.
|
|
|
|
|
* [RapidAPI](https://paw.cloud/) - Full-featured HTTP client for macOS.
|
|
|
|
|
|
|
|
|
|
### Mocking
|
|
|
|
|
|
|
|
|
|
* [FakeRest](https://github.com/marmelab/FakeRest) - Redirect fetch() calls to a client-side fake REST API.
|
|
|
|
|
* [json-server](https://github.com/typicode/json-server) - Serve a REST API from fixture files using quick prototyping.
|
|
|
|
|
* [RequestBin](https://requestbin.com/) - Inspect and debug webhook requests sent by your clients or third-party APIs.
|
|
|
|
|
* [httpbin](https://httpbin.org) - HTTP request and response service - a/k/a Swiss Army Knife for HTTP.
|
|
|
|
|
* [FakeRest](https://github.com/marmelab/FakeRest) - Patch XMLHttpRequest to fake a REST API client-side.
|
|
|
|
|
* [json-server](https://github.com/typicode/json-server) - Serve a REST API from fixture files using quick prototyping.
|
|
|
|
|
* [Mocky.io](https://www.mocky.io/) - Free online service to create fake HTTP responses.
|
|
|
|
|
* [MockServer](https://www.mock-server.com/) - Easy mocking of any system you integrate with via HTTP or HTTPS.
|
|
|
|
|
* [Request Baskets](https://github.com/darklynx/request-baskets) - Service to collect HTTP requests and inspect them via RESTful API or web UI.
|
|
|
|
|
* [DuckRails](https://github.com/iridakos/duckrails) - Mock quickly & dynamically API endpoints.
|
|
|
|
|
* [Mockoon](https://mockoon.com) - Easily create mock APIs locally. No remote deployment, no account required, open source.
|
|
|
|
|
* [Mockintosh](https://mockintosh.io/) - A mock server generator that's capable to generate RESTful APIs and communicate with the message queues to mimick asynchronous tasks.
|
|
|
|
|
* [Mockae](https://mockae.com/) - Fake REST API powered by Lua.
|
|
|
|
|
|
|
|
|
|
### Debugging Proxies
|
|
|
|
|
|
|
|
|
|
* [mitmproxy](https://mitmproxy.org/) - Free, open-source interactive HTTPS proxy for debugging API traffic.
|
|
|
|
|
* [Charles](https://www.charlesproxy.com/) - HTTP proxy/monitor for inspecting API traffic on Windows, Mac, and Linux.
|
|
|
|
|
* [Fiddler](https://www.telerik.com/fiddler) - Web debugging proxy tool by Telerik/Progress.
|
|
|
|
|
|
|
|
|
|
### Validating
|
|
|
|
|
|
|
|
|
@@ -259,9 +253,12 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
|
|
|
|
|
### Public REST APIs To Use In Tests
|
|
|
|
|
|
|
|
|
|
* [Public APIs](https://publicapis.dev/) - The world's largest directory of public APIs.
|
|
|
|
|
* [Deck of Cards API](https://deckofcardsapi.com) - Open API for simulating a deck of cards.
|
|
|
|
|
* [Public APIS](https://github.com/public-apis/public-apis) - Explore The Largest API Directory In The Galaxy.
|
|
|
|
|
* [Marvel Comics API](https://developer.marvel.com/) - Query characters, stories, events about Marvel superheroes.
|
|
|
|
|
* [JSON Placeholder](https://jsonplaceholder.typicode.com/) - Free online REST service that you can use whenever you need some fake data.
|
|
|
|
|
* [APIs.guru](https://APIs.guru) - Wikipedia for Web APIs, each API has OpenAPI/Swagger description.
|
|
|
|
|
* [JSON Placeholder](https://jsonplaceholder.typicode.com/) - Fake REST API abput posts, users and comments
|
|
|
|
|
* [The Cat API](https://theCatAPI.com) - Public API for Cats Images, Facts and Jokes.
|
|
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
|
|
|
@@ -271,9 +268,6 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [ReDoc](https://github.com/Rebilly/ReDoc/) - OpenAPI/Swagger-powered three-panel documentation.
|
|
|
|
|
* [Slate](https://github.com/lord/slate) - Beautiful and responsive three-panel API documentation using Middleman.
|
|
|
|
|
* [Optic](https://github.com/opticdev/optic) - Maintain an accurate API specification without writing OpenAPI/Swagger. Works with any Stack
|
|
|
|
|
* [Zudoku](https://zudoku.dev/) - Create clean, consistent API docs with Zudoku — open source, extensible, and developer-first
|
|
|
|
|
* [Sourcey](https://sourcey.com) - Open source documentation platform for OpenAPI specs and markdown. Static HTML output.
|
|
|
|
|
* [Stoplight](https://stoplight.io/) - Design-first API platform with visual OpenAPI editor, documentation, and mocking.
|
|
|
|
|
|
|
|
|
|
## API Gateway
|
|
|
|
|
|
|
|
|
@@ -282,15 +276,13 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [API Umbrella](https://github.com/NREL/api-umbrella) - API management platform for exposing web services, with web interface and analytics, written in Lua.
|
|
|
|
|
* [WSO2 API Management](https://github.com/wso2/product-apim) - API management tool with lightweight gateway and API lifecycle management, written in Java.
|
|
|
|
|
* [Express Gateway](https://github.com/ExpressGateway/express-gateway) - Microservices API Gateway built on top of ExpressJS (Node.js).
|
|
|
|
|
* [Lura](https://github.com/luraproject/lura) - Ultra performant API Gateway with middleware. Written in Go.
|
|
|
|
|
* [KrakenD](https://github.com/devopsfaith/krakend) - Ultra performant API Gateway with middleware. Written in Go.
|
|
|
|
|
* [AWS API Gateway](https://aws.amazon.com/api-gateway/) - Fully managed service that helps developers to create, publish, maintain, monitor, and secure APIs at any scale.
|
|
|
|
|
* [Zuplo](https://zuplo.com/) - OpenAPI-Powered API & MCP Management platform for Security, Deployment, and Documentation. Add auth, rate-limiting, and monetization to your API or MCP Server in minutes, written in TypeScript & Go.
|
|
|
|
|
|
|
|
|
|
## SaaS Tools
|
|
|
|
|
|
|
|
|
|
* [Nango](https://github.com/NangoHQ/nango) - Native integrations framework to consume REST APIs (open-source).
|
|
|
|
|
* [Runscope](https://www.runscope.com/) - Automated API Monitoring & Testing.
|
|
|
|
|
* [Keploy](https://keploy.io) - Open-source API testing and data mocking tool that generates test cases and stubs automatically from real traffic, enabling end-to-end API testing and monitoring.
|
|
|
|
|
* [Ping-API](https://ping-api.com/) - Automated API Monitoring & Testing.
|
|
|
|
|
* [Apiary](https://apiary.io/) - Collaborative design, instant API mock, generated documentation, integrated code samples, debugging and automated testing.
|
|
|
|
|
* [Amazon API Gateway](https://aws.amazon.com/api-gateway/) - Amazon API Gateway is a fully managed service that makes it easy for developers to create, publish, maintain, monitor, and secure APIs at any scale.
|
|
|
|
@@ -299,16 +291,13 @@ A collaborative list of great resources about RESTful API architecture, developm
|
|
|
|
|
* [Assertible](https://assertible.com) - Continuously test and monitor your APIs after deployments and across environments.
|
|
|
|
|
* [Moesif](https://www.moesif.com) - API Analytics for Debugging, Monitoring, and Usage Tracking for RESTful and GraphQL.
|
|
|
|
|
* [Beeceptor](https://beeceptor.com/) - An HTTP inspecting, mocking and proxing service. Gives named endpoints for creating mock API endpoints and simulate responses.
|
|
|
|
|
* [Apitally](https://apitally.io) - Analytics, request logging and monitoring for REST APIs with a focus on simplicity and data privacy.
|
|
|
|
|
* [BlazeMeter](https://www.blazemeter.com/) - Continuous testing platform for API performance and load testing at scale.
|
|
|
|
|
* [Loader.io](https://loader.io/) - Free cloud-based load testing service for APIs.
|
|
|
|
|
|
|
|
|
|
## Miscellaneous
|
|
|
|
|
|
|
|
|
|
* [shadcn-admin-kit](https://github.com/marmelab/shadcn-admin-kit) - Build internal tools, admin panels, B2B apps, and dashboards on top of any REST API
|
|
|
|
|
* [react-admin](https://github.com/marmelab/react-admin) - Add a ReactJS admin GUI to any RESTful API.
|
|
|
|
|
* [ng-admin](https://github.com/marmelab/ng-admin) - Add an AngularJS admin GUI to any RESTful API.
|
|
|
|
|
* [swagger-codegen](https://github.com/swagger-api/swagger-codegen) - Auto generation of client libraries or server stubs given an OpenAPI specification (formerly known as the Swagger Specification).
|
|
|
|
|
* [Lumber](https://github.com/ForestAdmin/lumber) - Generate the admin interface of your application.
|
|
|
|
|
* [Linx](https://linx.software) - Low-code API platform. Build, debug and host REST APIs
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|