How to Build a Perfect API Description

This page summarizes the projects mentioned and recommended in the original post on dev.to

SurveyJS - Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App
With SurveyJS form UI libraries, you can build and style forms in a fully-integrated drag & drop form builder, render them in your JS app, and store form submission data in any backend, inc. PHP, ASP.NET Core, and Node.js.
surveyjs.io
featured
InfluxDB - Power Real-Time Data Analytics at Scale
Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.
www.influxdata.com
featured
  • spectral-owasp-ruleset

    Improve the security of your API by detecting common vulnerabilities as defined by OWASP and enforced with Spectral.

  • For starters, let's make sure there are no obvious security mistakes showing up in our API design using the Spectral OWASP ruleset.

  • api-guidelines

    adidas group API design guidelines (by adidas)

  • Adidas

  • SurveyJS

    Open-Source JSON Form Builder to Create Dynamic Forms Right in Your App. With SurveyJS form UI libraries, you can build and style forms in a fully-integrated drag & drop form builder, render them in your JS app, and store form submission data in any backend, inc. PHP, ASP.NET Core, and Node.js.

    SurveyJS logo
  • style-guide

    A shared and somewhat opinionated style guide for everyone to enjoy. (by apisyouwonthate)

  • APIs You Won't Hate

  • box-openapi

    OpenAPI 3.0 Specification for the Box APIs

  • Box

  • mymove

    MyMove Personal Property Prototype

  • Transcom

  • spectral-ruleset

    Custom Spectral API Linter ruleset for Zalando RESTful API Guidelines.

  • Zalando

  • spectator

    OpenAPI testing for PHP (by hotmeteor)

  • For example, working with Laravel PHP, you can configure the popular testing tool Pest (or PHPUnit) to contract testing OpenAPI using Spectator.

  • InfluxDB

    Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

    InfluxDB logo
  • openapi_contracts

    Openapi schemas as API contracts

  • Ruby on Rails: openapi_contracts/ works with RSpec.

  • wiretap

    The world's coolest API Validation and compliance tool. Validate APIs against OpenAPI specifications and much more (by pb33f)

  • If you cannot find something to integrate with your existing test suite, consider using Wiretap which can run as a proxy, and handle contract testing of the requests/responses that come through it in testing or staging environments.

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts

  • What's the correct way to route URLs when there are "deep" one-to-many relationships?

    1 project | /r/django | 8 Jan 2021