From 2cec7ea04d1a1006a76ca4921aeaec00b4cc227f Mon Sep 17 00:00:00 2001 From: Derric Gilling Date: Mon, 26 Feb 2018 15:52:59 -0800 Subject: [PATCH 1/3] Add: Design articles and tools to README.md Add: Articles on API design, CORS, security, and Moesif SaaS tool. --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 1d3f0f9..bcd11d2 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,12 @@ the Design of Network-based Software Architectures](https://www.ics.uci.edu/~fie * [REST API Tutorial](http://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. * [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. * [API-Security-Checklist](https://github.com/shieldfy/API-Security-Checklist) - Best practices about REST API security +* [Guide to CORS](https://www.moesif.com/blog/technical/cors/Authoritative-Guide-to-CORS-Cross-Origin-Resource-Sharing-for-REST-APIs/) - Guide to how CORS works and common pitfalls around security by Moesif. +* [Authorization on REST APIs](https://www.moesif.com/blog/technical/restful-apis/Authorization-on-RESTful-APIs/) - Building authentication and authorization for REST APIs by Moesif. +* [REST Security Cheat Sheet](https://www.owasp.org/index.php/REST_Security_Cheat_Sheet) - REST Security Cheat Sheet by OWASP. +* [Filtering, Sorting, and Pagination](https://www.moesif.com/blog/technical/api-design/REST-API-Design-Filtering-Sorting-and-Pagination/) - REST API Design: Filtering, Sorting, and Pagination by Moesif. +* [API Design Guidelines](https://zalando.github.io/restful-api-guidelines/index.html/) - REST API and Event Scheme Guidelines by Zalando. +* [API Design Overview](https://codeplanet.io/principles-good-restful-api-design/) - Principles of good REST API Design by Code Planet. ## Standards @@ -213,6 +219,7 @@ the Design of Network-based Software Architectures](https://www.ics.uci.edu/~fie * [API doc](http://apidocjs.com/) - Inline Documentation for RESTful web APIs. * [raml2html](https://github.com/raml2html/raml2html) - Generates HTML documentation from a RAML file. * [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. ## SaaS tools @@ -223,6 +230,7 @@ the Design of Network-based Software Architectures](https://www.ics.uci.edu/~fie * [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. * [Apigee](https://apigee.com) - Apigee is the leading provider of API technology and services for enterprises and developers. * [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. ## Miscellaneous From f568dd3dcdcb1a3d843864f0e893f6a022febbdf Mon Sep 17 00:00:00 2001 From: Derric Gilling Date: Mon, 26 Feb 2018 16:54:35 -0800 Subject: [PATCH 2/3] Fix: Broken link for Zalando API Design post --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bcd11d2..03908c6 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,7 @@ the Design of Network-based Software Architectures](https://www.ics.uci.edu/~fie * [Authorization on REST APIs](https://www.moesif.com/blog/technical/restful-apis/Authorization-on-RESTful-APIs/) - Building authentication and authorization for REST APIs by Moesif. * [REST Security Cheat Sheet](https://www.owasp.org/index.php/REST_Security_Cheat_Sheet) - REST Security Cheat Sheet by OWASP. * [Filtering, Sorting, and Pagination](https://www.moesif.com/blog/technical/api-design/REST-API-Design-Filtering-Sorting-and-Pagination/) - REST API Design: Filtering, Sorting, and Pagination by Moesif. -* [API Design Guidelines](https://zalando.github.io/restful-api-guidelines/index.html/) - REST API and Event Scheme Guidelines by Zalando. +* [API Design Guidelines](https://zalando.github.io/restful-api-guidelines/index.html) - REST API and Event Scheme Guidelines by Zalando. * [API Design Overview](https://codeplanet.io/principles-good-restful-api-design/) - Principles of good REST API Design by Code Planet. ## Standards From 95746bca48efee87b0b7e77d0639159ac47f6b23 Mon Sep 17 00:00:00 2001 From: Derric Gilling Date: Thu, 8 Mar 2018 12:12:35 -0800 Subject: [PATCH 3/3] Update README.md Remove extra articles --- README.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/README.md b/README.md index 03908c6..0faaaaf 100644 --- a/README.md +++ b/README.md @@ -44,12 +44,6 @@ the Design of Network-based Software Architectures](https://www.ics.uci.edu/~fie * [REST API Tutorial](http://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. * [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. * [API-Security-Checklist](https://github.com/shieldfy/API-Security-Checklist) - Best practices about REST API security -* [Guide to CORS](https://www.moesif.com/blog/technical/cors/Authoritative-Guide-to-CORS-Cross-Origin-Resource-Sharing-for-REST-APIs/) - Guide to how CORS works and common pitfalls around security by Moesif. -* [Authorization on REST APIs](https://www.moesif.com/blog/technical/restful-apis/Authorization-on-RESTful-APIs/) - Building authentication and authorization for REST APIs by Moesif. -* [REST Security Cheat Sheet](https://www.owasp.org/index.php/REST_Security_Cheat_Sheet) - REST Security Cheat Sheet by OWASP. -* [Filtering, Sorting, and Pagination](https://www.moesif.com/blog/technical/api-design/REST-API-Design-Filtering-Sorting-and-Pagination/) - REST API Design: Filtering, Sorting, and Pagination by Moesif. -* [API Design Guidelines](https://zalando.github.io/restful-api-guidelines/index.html) - REST API and Event Scheme Guidelines by Zalando. -* [API Design Overview](https://codeplanet.io/principles-good-restful-api-design/) - Principles of good REST API Design by Code Planet. ## Standards