You are browsing a read-only backup copy of Wikitech. The live site can be found at

User:Alex Paskulin/API catalog

From Wikitech-static
< User:Alex Paskulin
Revision as of 23:11, 2 December 2021 by imported>Nikki Nikkhoui (→‎catalog-info.yaml schema)
Jump to navigation Jump to search

The API catalog is a list of Wikimedia APIs.

Browse the API catalog

About the API catalog

The API catalog is a project of the API Platform Team. The purpose of the catalog is to help API producers and consumers, primarily within the Wikimedia Foundation, discover and manage APIs. The API catalog is currently in beta and uses the open-source Backstage platform hosted on Toolforge.

Add an API to the catalog

To add an API to the catalog, add a catalog-info.yaml file to the root directory of your project repository. For projects whose repository name includes "mediawiki/services" and exists in the Wikimedia GitHub organization, the API catalog will automatically discover and load the API information into Backstage. For projects whose repository name does not include "mediawiki/services", you must manually add the URL to your project's catalog-info.yaml file to Backstage. [add screenshots of UI?]

catalog-info.yaml example

# Wikimedia API catalog descriptor file
kind: API
  name: example-api
  description: an example node api
    - rest
  type: openapi
  lifecycle: production
  owner: Platform Engineering Team
    $text: ./spec.yaml

catalog-info.yaml schema

For the complete schema, visit the Backstage docs.


required | string

Must be

required | string

API for all APIs

required | string

Unique API name using lowercase letters and dashes

required | string

Short and informative overview of the API

optional | list

List of tags to classify APIs by type and other attributes
  • rest: tag for RESTful APIs

required | string

  • openapi for an OpenAPI spec in YAML or JSON format (version 2 or 3)
  • graphql for a GraphQL schema

For the complete list of supported types, visit the Backstage docs.


required | string

To do: Add these

required | string

To do: Figure this out

required | string

Location of the API spec relative to the project's root directory.

Alternative workflow: Manual upload

Instead of adding a file to the project repository, you can add an API to the catalog by uploading a catalog-info.yaml file to the Backstage repository data/apis directory.

Frequently asked questions

Questions and feedback

To share feedback or ask a question, comment on the talk page.