RESOURCES.md

Wechaty Puppet OpenAPI Specification (OAS)

Wechaty REST API Server with OpenAPI Specification (Swagger)

Learning Resources

gRPC

• 探讨 gRPC 的 Node 技术生态及实现工具
• gRPC Basics - Node.js
• Building a gRPC service with Node.js
• gRPC in 3 minutes (Node.js)
• Listen gRPC and HTTP requests on the same port
• gRPC to JSON proxy generator following the gRPC HTTP spec
• 如何在 Node.js 中更优雅地使用 gRPC：grpc-helper

Documentation

• OpenAPI Specification v3.1
• gRPC with REST and Open APIs
• OpenAPI Initiative Style Guide

Tools

• openapi2proto - A tool for generating Protobuf v3 schemas and gRPC service definitions from OpenAPI specifications
• OpenAPI.Tools

gRPC Web

• gRPC-Web: Moving past REST+JSON towards type-safe Web APIs
• Library for making gRPC-Web requests intended for TypeScript from either a browser or Node.js.

Reverse Engineering

• A toolset for reverse engineering and fuzzing Protobuf-based apps

RESTful API Naming Convention

• REST Resource Naming Guide
• 10+ Best Practices for Naming API Endpoints
• PUT vs. POST in REST
• Google Cloud Common Design Patterns
• REST based Services/Architecture vs. RESTFUL Services/Architecture

Tutorials

• Talk video: Writing REST Services for the gRPC curious, Johan Brandhorst, 2019, GopherCon UK
• Take a REST with HTTP/2, Protobufs, and Swagger
• All the boilerplate you need to get started with writing grpc-gateway powered REST services in Go