api.md

API

Linear API is interestingly made. Stripe has nice API docs too. Currently looking into Apiker for releasing my APIs.

Redocusaurus seems nice for API docs. Svix is great for webhooks. tRPC is nice for API access.

Love using Dash and it's Alfred workflow on macOS for searching docs.

Other

• OpenAI API
• Google Drive
• GitHub
• GitHub Go - Client library for accessing GitHub GraphQL API.
• GitHub Swift
• GitHub JS - Extendable client for GitHub's REST & GraphQL APIs.
• GitHub JS 2 - GitHub API HTTP client with cache support to get the most of your rate limit.
• GitHub JS 3 - All-batteries-included GitHub SDK for Browsers, Node.js, and Deno.
• GitHub JS REST
• GitHub Rust
• GitHub Rust 2
• GitHub Swift - Swift framework for the GitHub API.
• GitHub Swift 2
• GitHub Swift 3 - Swift API Client for GitHub and GitHub Enterprise.
• GitHub Python
• GitHub Julia
• GitHub OCaml
• GitHub Haskell
• GitHub R
• GitHub Gists Python - Advanced python wrapper for Github Gist API.
• Hacker News - Documentation and Samples for the Official HN API.
• Dropbox - Command line client for Dropbox built using the Go SDK.
• Dropbox JS - Dropbox JavaScript SDK.
• Twitter TS (Tweet)
• Twitter TS 2
• Twitter Go
• Twitter Go 2 - Go Twitter REST and Streaming API v1.1
• Twitter Go 3
• Twitter Go 4
• Twitter Go 5
• Twitter Ruby - Twitter OAuth 2.0 Client Library in Ruby.
• Twitter Swift
• Twitter Python - Actively maintained, pure Python wrapper for the Twitter API. Supports both normal and streaming Twitter APIs.
• Twitter Python 2
• Twitter Python 3
• Twitter Python 4
• Twitter Rust
• Twitter Rust 2
• Twitter R
• Twitter Node - Strongly typed, full-featured, light, versatile yet powerful Twitter API v1.1 and v2 client for Node.js.
• Twitter Node 2 - Twitter API Client for node (REST & Streaming API).
• Twitter Node 3
• Twitter Node 4 - Twitter API v2 client for TypeScript auto-generated from official OpenAPI specification.
• Twitter Lite JS - Tiny, full-featured, flexible client / server library for the Twitter API.
• Twitter Haskell
• Twitter API proxy server using gRPC
• Twitter profile dumper (downloader) with authorization swapping
• Twitter Post Fetcher - Fetch your twitter posts without using the new Twitter.
• arxiv-graphql - GraphQL API for arXiv: e-print service by Cornell University.
• Sheetfu - Python library to interact with Google Sheets V4 API.
• Cloudflare Rust - Rust library for the Cloudflare v4 API.
• Cloudflare Node
• YouTube Search Python - Search for YouTube videos, channels & playlists. Get video & playlist information using link. Get search suggestions.
• GIPHY SDKs
• OpenAI JS - Tiny client module for the openAI API.
• Notion JS - Unofficial Node.js API client for Notion.
• Notion TS - Unofficial Notion.so Wrapper.
• Notion Go
• Notion Python - Unofficial Python API client for Notion.so.
• VK Go
• VK Python
• VK Kotlin
• VK API JSON Schema
• Google Cloud - Google Cloud Client Library for Python.
• Reddit Python
• Reddit Go
• Reddit Go 2
• Reddit Go 3
• Reddit JS - Simple Reddit API client in JS.
• Reddit OCaml
• Goodreads API Go
• SendGrid Go
• OpenSea Go
• OpenSea Python
• Fastly Go - CLI for interacting with the Fastly platform.
• Google Docs Go - Go library for reading and writing spreadsheet files on Google Docs.
• Slack Go 2
• Slack Go 3 - Slack client for go.
• Slash Go 4 - Router for Slack's slash commands.
• Slack Go 5 - Slack Bot Framework in Go.
• Slack Julia
• Slack Deno
• Stripe Go
• Stripe Rust - Asynchronous Rust API bindings for the Stripe HTTP API.
• Yandex Music Python
• Star Wars API - Nice for testing.
• Google Spreadsheet NodeJS - Most popular Google Sheets API wrapper for JavaScript.
• Degiro Python
• Airtable JS
• Airtable Go
• Airtable Go 2
• WikipediaKit - API Client Framework for Swift.
• Zendesk Go - Zendesk API client library for Go.
• Cantine - Cooking recipe search JSON API with over a million recipes.
• Binding and CLI generator for all google APIs
• CartQL - GraphQL Shopping Cart API.
• Customer.io Node API
• Binance Go
• Stream - Enterprise Grade Feed & Chat APIs.
• Telegraph API - Minimalist publishing tool that allows you to create richly formatted posts and push them to the Web in just a click.
• Telegraph Deno
• Intercom Node - Node.js bindings for the Intercom API.
• Pocket Export - Export/access your Pocket data, including highlights.
• Pocket Python
• AssemblyAI - Top Rated API for Speech-to-Text.
• Apple News API Client
• Digital Ocean Go - Go client library for accessing the DigitalOcean V2 API.
• Digital Ocean Python
• WhatsApp TS
• WhatsApp Go - WhatsApp Web API.
• Facebook Graph API SDK Go
• Trello Go - Trello API wrapper for Go.
• Gumroad Node
• LinkedIn Node
• Gophercloud Go - OpenStack Go SDK.
• AWS SDK Rust
• pyiCloud - Python + iCloud wrapper to access iPhone and Calendar data.
• Spotify TS - Isomorphic TypeScript wrapper for Spotify's Web API.
• Spotify TS 2
• Spotify TS 3
• Spotify Go
• Spotify GraphQL - GraphQL schema for Spotify WebAPI.
• Spotify Python
• Spotify Rust
• Spotify Rust 2
• Spotify Rust 3
• Spotify iOS SDK
• Spotify Swift
• Spotify Elixir
• Rutracker Node API
• Coinbase Rust
• Replit Container SDK - JavaScript client that speaks Replit's container protocol.
• Last.fm and Libre.fm Python
• Toggl Python
• Chromecast Node
• Apple Music Go
• Gfycat Python
• TikTok Python - Unofficial API.
• Apple Music Go
• Interactive Brokers Go
• Google News Python
• TensorFlow Rust - Rust language bindings for TensorFlow.
• libgit2 Rust - libgit2 bindings for Rust.
• LLVM Rust - Friendly LLVM library for Rust.
• Fastly Go
• Google Suggest API
• Incident.io Go
• CoinGecko Go
• Linear GraphQL API
• Iron Fish - Public Iron Fish API.
• SpaceX API - Open Source REST API for rocket, core, capsule, pad, and launch data.
• Microsoft Graph SDK for Go
• GitLab Node - GitLab API NodeJS library with full support of all the Gitlab API services.
• GitLab Go
• GitLab Go 2
• N26 Go
• Grammarly
• Google Maps Services Go
• GCP Haskell - Comprehensive Google Services SDK for Haskell.
• Robintrack - Scrapes the Robinhood API to retrieve + store popularity and price data. (Web)
• OpenAI API (HN)
• Tesla Swift
• Wayback Machine Python
• Medium API
• Backblaze Go
• Paddle Go
• Paddle TS - SDK to interface with the API and web hooks from Paddle.
• PyTrends - Unofficial API for Google Trends.
• Azure Python
• Typeform JS SDK
• Twitch GraphQL
• Twitch Rust
• Finage - Stock,Currency and Crypto Real-Time API.
• Vonage API - Everything you need to build connected applications. (Code)
• Bing Web Search API
• TalkJS - Chat API and Javascript SDK for websites and apps.
• Exchangerate.host - Free API service for crypto and foreign exchange rates. (HN)
• Rick and Morty API - RESTful and GraphQL API based on the television show Rick and Morty.
• Dog API
• Square Node (Release)
• Square Web SDK

Notes

• API should be only sending values it actually has or at least not null but same type values: e.g. items array should never turn null even if empty but rather an empty array.
• APIs should be built around the needs of the consumers, not the providers
• Treat users as "busy" rather than "idiots". Don't underestimate users. Build libraries, not (just) scripts. Teach by example. With this perspective, good API design falls into place: 1. Layered API with good defaults. 2. Short high-currency examples. 3. Paced introduction to more concepts.

Links

• Transposit - API composition platform.
• Postwoman - API request builder - A free, fast, and beautiful alternative to Postman.
• Build an external api with auth using Traefik and Go
• Public APIs - Collective list of free APIs for use in software and web development. (HN)
• Kong - Connect all your microservices and APIs with the industry’s most performant, scalable and flexible API platform.
• Amazon API Gateway Serverless Developer Portal - Application that you use for developer engagement by making your API Gateway APIs available to your customers through self-service discovery of those APIs.
• Stone - Write your APIs in stone.
• OpenAPI Specification - Standard for describing modern APIs. (Code)
• OpenAPI Compliance Proxy - Validates requests and responses against an OpenAPI document.
• Stoplight Studio - Design APIs 10x faster with our free OpenAPI editor. Prototype and share your API within minutes. (Code)
• WorkOS - APIs for enterprise features like SSO/SAML. (HN)
• NoCodeAPI - Quickly set-up third party application APIs.
• Pipedream - AWS Lambda + Zapier alternative .Develop any workflow, based on any trigger. Workflows are code, which you can run for free. (Code) (HN)
• An Introduction to APIs
• Paragon - Visually create production-ready API workflows. (HN)
• Saasify - Handles all of the SaaS boilerplate, including user accounts, subscription billing, developer docs, and a polished marketing site.
• Hoverfly - Lightweight, open source API simulation tool. Using Hoverfly, you can create realistic simulations of the APIs your application depends on.
• MetaMate - Open-source semantic service bus and provides you an api for everything. (Web)
• Unofficial APIs list
• OpenAutoComplete - Shell-agnostic, declarative CLI autocomplete specification.
• Best practices for building SDKs for APIs (2019)
• Ask HN: Best practices (and examples) for designing client libraries for APIs? (2020)
• apigentools - Generate API clients from OpenAPI v3 specification for multiple languages using openapi-generator.
• OpenAPI Generator - Generate clients, servers, and documentation from OpenAPI documents. (Code)
• Lessons learned designing APIs (2019)
• Ask HN: Best Way to Mock APIs in 2020?
• Paperclip - OpenAPI tooling for Rust.
• Standard Library - Design with APIs, prototype, and release integrations faster with Autocode.
• APIs are about Policy (2019)
• APIs with GitHub - Simple tool to make JSON APIs for quick use for your basic projects. Your APIs are hosted on GitHub as JSON file that's simple.
• Akita Software - Helping people get visibility into their software through their APIs.
• A personal API (2019)
• The API Economy
• Mock Service Worker (MSW) - Seamless REST/GraphQL API mocking library for browser and Node. (Web) (Examples) (GitHub)
• Rusty's API Design Manifesto
• Top 10 Social Media APIs for Developers (2020)
• Slate - Beautiful static documentation for your API. (HN)
• The land before modern APIs (2020)
• How should we build the APIs of tomorrow? (2020) (HN)
• Top Tools to Make Debugging APIs Easier (2020)
• Bearer.sh - Monitor, track performance, detect anomalies, and fix issues on your critical API usage.
• APIs You Won't Hate - Community that cares about API design and development.
• Ask HN: Suggestions for books about API design? (2020)
• How To Design A Good API and Why it Matters (2007)
• Regarding Semantic Versioning (2020) (Lobsters)
• Swagger UI - Collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
• Swagger Codegen - Contains a template-driven engine to generate documentation, API clients and server stubs in different languages by parsing your OpenAPI / Swagger definition.
• Catch Breaking Changes by Diffing API Traffic (2020) (HN)
• Cloudflare API Shield (2020)
• Abstract API - Suite of fast, accurate, & robust APIs.
• Stargate - Open source API framework for data. Data gateway deployed between client applications and a database. (Web) (Hello GraphQL; meet Cassandra)
• API pagination design (2020) (Lobsters)
• Insomnia - API Design Platform and REST Client. (Code)
• Apiary - Platform for API Design, Development & Documentation. (How Apiary Works)
• Customizing API Documentation with Next.JS, Tailwind CSS, and ReadMe (2020)
• OpenAPI 3 Generator - Faster way to prototype your APIs using OpenAPI 3 and Swagger UI. (HN)
• Hoppscotch - Free, fast and beautiful API request builder. (Code) (HN)
• Optic - APIs that Document and Test Themselves. (Code)
• Pizzly - Simplest, fastest way to integrate your app with OAuth APIs. (Web)
• Swell - API development tool that enables developers to test endpoints served over streaming technologies including Server-Sent Events (SSE), WebSockets, HTTP2, GraphQL and gRPC. (Web)
• API design is stuck in the past (2020) (HN)
• APISprout - Lightweight, blazing fast, cross-platform OpenAPI 3 mock server with validation.
• List of Great Product API Docs (2020)
• Bitmasks for nicer APIs (2020)
• Apache APISIX - Dynamic, real-time, high-performance API gateway, based on the Nginx library and etcd. (Web)
• APIsFinder - Find Over 680 public and open REST APIs for developers. (Code)
• APIs All the Way Down (2020)
• What's good about offset pagination; designing parallel cursor-based web APIs (HN)
• The API Book (Code)
• API-Less Architecture
• Mocker API - Creates mocks for REST APIs. It will be helpful when you try to test your application without the actual REST API server.
• Building DigitalOcean's API Gateway (2021) (HN)
• AWS Smithy - Language for defining services and SDKs. (Code) (HN)
• Smithy Rust - Smithy code generators for Rust.
• DevDocs - API Documentation Search. (Code)
• Metapine - Discover new & interesting APIs.
• Hydra: Hypermedia-Driven Web APIs
• A Theory of Robust API Knowledge (2021)
• Public APIs - Directory of Free Public & Open Rest APIs.
• swagger-typescript-api - TypeScript API generator via Swagger scheme.
• Pusher - Bi-directional hosted APIs that are flexible, scalable and easy to use. (GitHub)
• Mockoon - Create mock APIs in seconds. (Code)
• ROAPI - Create full-fledged APIs for static datasets without writing a single line of code. (Docs)
• Autocode - Instant endpoints for anything.
• HN: Google’s copying of the Java SE API was fair use (2021)
• Using Postman and APIMatic to Document APIs and Generate Client Libraries (2021)
• Read from databases, write to APIs (2021) (Lobsters)
• Stoplight Elements - Beautiful API documentation powered by OpenAPI and Markdown. (Code)
• API Versioning Has No "Right Way" (2017)
• API Specification Toolbox - Project to try and define the world of API specifications. (Code)
• API Blueprint - Powerful high-level API description language for web APIs. (Code)
• 4 essential characteristics of successful APIs (2021)
• The Architecture of Uber's API gateway (2021)
• Small things that make APIs a little bit better for its users (2021) (Lobsters)
• AIP Improvement Proposals - Focused design documents for flexible API development. How Google does APIs. (Code)
• The state of Stripe API library codegen (2021)
• API Federation: growing scalable API landscapes (2021)
• Zanzibar - Build system & configuration system to generate versioned API gateways.
• API Design Cheat Sheet
• M3O - Open source AWS alternative. Programmable building blocks for everyday use. (HN) (Code) (HN)
• Notes on streaming large API responses (HN)
• How to Cancel Pending API Requests to Show Correct Data (2021)
• Give me /events, not webhooks (2021) (Lobsters) (HN)
• Cats - Generate tests at runtime based on OpenApi specs.
• Portman - Port OpenAPI Spec to Postman Collection, with contract & variation tests included.
• RapidAPI - Next Generation API Platform. (Twitter) (How it started)
• Portman CLI 1.0 - Better API testing (2021)
• Test and Deploy your APIs Using These Open Source Tools (2021)
• How to Hack APIs in 2021 by Hakluke and Farah Hawa (2021) (HN)
• JSON:API - Specification for building APIs in JSON. (Code)
• API Tokens: A Tedious Survey (HN)
• Adding Optimistic Locking to an API (2021) (HN)
• Data-first API design (2021)
• Schemathesis - Modern API testing tool for web applications built with Open API and GraphQL specifications.
• So you want to mock an API (2021)
• API Star - Toolkit for working with OpenAPI or Swagger schemas. (Docs)
• RapiDoc - Custom-Element for OpenAPI Spec. Create beautiful, customizable, interactive API documentation from OpenAPI Specification. (Code)
• Appwrite - Open-Source End-to-End Backend Server. (Code) (Demos for Functions) (Getting Started With Appwrite's Apple SDK) (HN)
• gnostic - Go command line tool which converts JSON and YAML OpenAPI descriptions to and from equivalent Protocol Buffer representations.
• Postman - API platform for building and using APIs. (GitHub) (Tweet)
• Blobr - Get your branded API portal in minutes.
• orval - Generate client with appropriate type-signatures (TypeScript) from any valid OpenAPI v3 or Swagger v2 specification, either in YAML or JSON formats. (Code)
• Exploring Programmers' API Learning Processes (2021)
• Opinionated OpenAPI v3 code generator for Go
• From feature request to API design (2019) - Describe the process of creating an API based on specific users' needs.
• APIs.guru - Directory of API definitions in OpenAPI (or Swagger) 2.0 and 3.x formats. (Code) (GitHub)
• Building the Brex API (2021) (HN)
• Anatomy of a Great API Library (2021)
• Making retries safe with idempotent APIs (Tweet)
• Backpressure And The Replicator (2021) (Lobsters)
• The Little Manual of API Design (2008)
• Remote Execution API - API that, at its most general, allows clients to request execution of binaries on a remote system.
• SwagGen - OpenAPI/Swagger 3.0 Parser and Swift code generator.
• 6 API lessons learned over the last 15 years by AWS (2021)
• Don’t Build A General Purpose API To Power Your Own Front End (2021)
• Docusaurus OpenAPI - OpenAPI plugin for generating API reference docs in Docusaurus v2.
• Kin OpenAPI - OpenAPI 3.0 implementation for Go (parsing, converting, validation, and more).
• Varlink - APIs – plain-text, type-safe, discoverable, self-documenting, remotable. (GitHub) (Go Code)
• Continuous API management
• The Light and Dark Side of the API Economy (2020)
• Prism - Open-Source HTTP Mock and Proxy Server. Turn any OpenAPI2/3 and Postman Collection file into an API server with mocking, transformations and validations. (Code)
• Telefunc - Remote Functions. Instead of API. (Code)
• OpenAPI Generator CLI - Allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec.
• OpenAPI CLI toolset - OpenAPI CLI toolbox with rich validation and bundling features.
• Redocly - API docs you can be proud of. (GitHub)
• Awesome API Security
• Documenting APIs (HN)
• OpenAPI boilerplate - Multi-file boilerplate for Open API Specification.
• dummy - Run mock server based on API contract with one command. Written in Go.
• Hook Slinger - Generic service to send, retry, and manage webhooks.
• API Guideline: Clarity at the point of use
• Newman - Command-line collection runner for Postman.
• openapi-sampler - Tool for generation samples based on OpenAPI payload/response schema.
• Redocusaurus - OpenAPI for Docusaurus v2 with Redoc.
• Dash Docset Builder
• AsyncAPI - AsyncAPI specification allows you to create machine-readable definitions of your asynchronous APIs. (Web)
• APIs as ladders (2022) (Tweet)
• Building API Docs (HN)
• Keygen - Software Licensing and Distribution API. (GitHub)
• CORS is not meant to secure an API endpoint (HN)
• Netlify Graph - Enables developers to seamlessly integrate third-party APIs and services into their web applications without writing API-specific code. (Article) (HN)
• Sphinx AutoAPI - New approach to API documentation in Sphinx.
• OpenAPI Codegen - Tool for generating code base on an OpenAPI schema.
• API design guidelines
• Oxide Rust
• Oxide Go
• Keploy - No code API testing platform. Create unit tests and mocks from API calls.
• Postman Code Generators - Common repository for all code generators shipped with Postman.
• Docgen - Transform your postman collection to HTML/Markdown documentation.
• Anicca - Get a diff between two OpenAPI descriptions.
• Apitest - Declarative API testing tool with JSON-like DSL.
• topi - Terminal OpenAPI documentation viewer.
• Kable - Usage-based Billing for API Products. (HN)
• Google API Design Guide
• How to Design Better APIs (2022) (HN)
• Postman to k6 - Converts Postman collections to k6 script code.
• What caused the Uber Eats glitch that allowed ordering free food for a weekend in India
• Cadl - Language for describing cloud service APIs and generating other API description languages, client and service code, documentation, and other assets.
• Cloudflare API Gateway (2022)
• Introducing Advanced Rate Limiting (2022)
• Cherrybomb - CLI tool that helps you avoid undefined user behavior by validating your API specifications.
• Theneo - High-Quality, Interactive API Docs. (HN)
• The Guild - Modern API Platform and ecosystem that scales. (Code)
• Why isn't there a swagger/openapi for binary formats? (2022)
• Why we chose NanoIDs for PlanetScale's API (2022)
• Yaade - Open-source, self-hosted, collaborative API development environment. (HN)
• Reservation-style rate limiting APIs (2022)
• Bad Magic - Swagger-UI alternative that allows developers to visualize and test their API resources from a convenient web interface.
• The complete guide to protecting your APIs with OAuth2 (2022)
• Building a stateless API proxy (2019) (Tweet)
• Request - Open-source api development application for minimalists.
• Fusebit - Build integrations for your app with ease.
• OpenAPI Validator - Configurable and extensible validator/linter for OpenAPI documents.
• Hyper - One consistent, frictionless API to manage data, cache, storage, search, and queue services. (Hyper Remix Stack) (Code)
• Akita - Helps you make sense of API traffic. Passively watch API traffic with apidump. Model API behavior with apispec. Compare API behavior with apidiff. (CLI)
• Public API Lists
• Predator - Powerful open-source platform for load testing APIs. (Web)
• mitmproxy2swagger - Automagically reverse-engineer REST APIs via capturing traffic.
• Open Source API Firewall - Fast and light-weight API proxy firewall for request and response validation by OpenAPI specs.
• Ply - API Automated Testing. (Web)
• Automatic SDK generation from an OpenAPI definition
• Paginating Requests in APIs (2020) (HN)
• Thin Platforms – Stratechery (2022)
• Serverless OpenAPI Documentation Plugin - Generates OpenAPI 3.0.0 documentation from serverless configuration files.
• JSONPlaceholder - Free Fake REST API. (Code)
• Zod to OpenAPI - Library that generates OpenAPI (Swagger) docs from Zod schemas.