Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ReadMe Metrics Api Specification API

The Api Specification API from ReadMe Metrics — 1 operation(s) for api specification.

ReadMe Metrics Api Specification API is one of 5 APIs that ReadMe Metrics publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Api Specification. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 2 operations across 1 path, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://dash.readme.com/api/v1.

2 operations 1 paths 2 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Server
https://dash.readme.com/api/v1
Authentication
HTTP Basic
Contact
Resource Areas
1

Authentication & Security 1

ReadMe Metrics Api Specification API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — ReadMe API key supplied as the HTTP Basic username (password empty).

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Api Specification 2
GET
/api-specification
List API specifications
getAPISpecifications 3 params → 200401403404
POST
/api-specification
Upload an API specification
uploadAPISpecification 1 param body → 201400401403408

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are APISpecification (7 properties), Error (6 properties). Each schema is shown below with its type and property counts.

APISpecification
object
7 properties
Error
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

readme-metrics-api-specification-api-openapi.yml Raw ↑

Other APIs ReadMe Metrics publishes across the network.

ReadMe Metrics
ReadMe Metrics Api Registry API
ReadMe Metrics Changelogs API
ReadMe Metrics Docs API