Archive

Reading

Everything I know about good API design by sean goedecke

Tools

The following should be considered as alternatives for Postman.

1. bruno -- open source API client similar to Postman, Insomnia and similar tools. Bruno stores your collections directly in a folder on your filesystem. We use a plain text markup language, Bru, to save information about API requests.  You can use git or any version control of your choice to collaborate over your API collections.

2. RapidAPI for Mac is a full-featured HTTP client that lets you test and describe the APIs you build or consume. It has a beautiful native macOS interface to compose requests, inspect server responses, generate client code and export API definitions.

dreamhead/moco: Easy Setup Stub Server

• Write your own configuration file to describe your Moco server configuration as follow: (foo.json)

[
  {
    "response" :
      {
        "text" : "Hello, Moco"
      }
  }
]

• Run Moco HTTP server with the configuration file.

java -jar moco-runner-<version>-standalone.jar http -p 12306 -c foo.json

• Now, open your favorite browser to visit http://localhost:12306 and you will see "Hello, Moco".

roapi/roapi: Create full-fledged APIs for slowly moving datasets without writing a single line of code. -- ROAPI automatically spins up read-only APIs for static datasets without requiring you to write a single line of code. It builds on top of Apache Arrow and Datafusion. The core of its design can be boiled down to the following:

• Query frontends to translate SQL, GraphQL and REST API queries into Datafusion plans.
• Datafusion for query plan execution.
• Data layer to load datasets from a variety of sources and formats with automatic schema inference.
• Response encoding layer to serialize intermediate Arrow record batch into various formats requested by client.

Don't use GraphQL -- Why, after 6 years, I’m over GraphQL; May 2024, via

Introduction

Describe your data:

type Project {
  name: String
  tagline: String
  contributors: [User]  }

Ask for what you want:

{
  project(name: "GraphQL") {
    tagline
    }
}

Get predictable results:

{
  "project": {
    "tagline": "A query language for APIs"
    }
}

Tools

Use roapi to create GraphQL frontend for static datasets without writing code.