feynon / craft

Organize and play around with REST, GraphQL, gRPC, and WebSocket APIs in a single place

Craft Project Proposal

Objective

Build a cross platform tool where developers can organize and play around with REST, GraphQL, gRPC, and WebSocket APIs in a single place.

Background

There is currently no single tool allowing developers to test & organize REST, GraphQL, gRPC, WebSocket APIs together.

• Postman: REST / GraphQL
• Insomnia: REST / GraphQL
• GraphQL Playground: GraphQL
• Smart Websocket Client Chrome extension: WebSocket
• BloomRPC: gRPC

However, real world software systems often use more than one technology stack to achieve their specific performance & maintenance needs.

For smart hardware ecosystems, engineers frequently have to work with raw UDP, TCP, and Bluetooth protocols. Currently, they use Wireshark to analyze RAW network packets.

Architecture

Roadmap

v1

• Send simple REST request to any backend with custom header, method, and body (mininal UI)
• Send GraphQL request to any backend with custom query (mininal UI)
• Connect to any Web socket server. Send custom message and receive response from the server (mininal UI)
• Send gRPC (H2C/HTTPS) requests to any any backend (mininal UI)
• Save & group APIs into services (directories)
• Import REST apis from OpenAPI 3.0 spec
• Show GraphQL documentation after user filled in the base URL
• Import gRPC apis from .proto file
• Attach markdown document to the apis
• Export directory so that it can be version controlled
• Enable syntax highlighting for JSON payload
• Enable syntax highlighting for GraphQL query
• Enable syntax highlighting for gRPC request
• Redesign the UI so that it's clear, convenient, easy to use, and looks good

v2

• Support Google, Facebook, and Github sign in
• Save directories to backend
• Generate shareable for a directory or a API
• Create teams and add members
• Share directories with in the team
• Provide web hooks so that devs can do continuous delivery for their directory
• Share directories to public
• Search public directories

v3

• Mock HTTP API
• Mock GraphQL API
• Mock Web Socket API
• Mock gRPC API
• Companies maintain their public API directory
• Developers purchase quota package for paid APIs
• Send & receive raw UDP packets
• Send & receive raw TCP packets
• Send & receive bluetooth packets
• Export UDP & TCP APIs for version control
• Mock UDP API
• Mock TCP API
• Mock Bluetooth
• Pre Request Scripts (Need more research)
• Automated Testing - Ability to write test suites for API collections (Need more research)