parse_openapi_spec: Parse an OpenAPI spec

In tibblify: Rectangle Nested Lists

Parse an OpenAPI spec

Description

The OpenAPI Initiative is a Linux Foundation project to define an OpenAPI Specification, a formal standard for describing HTTP APIs. Use parse_openapi_spec() to parse such OpenAPI specs. You can also parse OpenAPI Schema Objects (which describe the structure of input and output datatypes) directly with parse_openapi_schema().

Usage

parse_openapi_spec(file)

parse_openapi_schema(file)

Arguments

file	(character(1)) A path to a file, a connection, or literal data.

Value

For parse_openapi_spec(), a nested data frame with the columns

• endpoint (character) Name of the endpoint.

• operations (list) A list of data frames describing that endpoint. See the Paths Object in the OpenAPI spec for details. All references (⁠$ref⁠) in the spec are resolved.

For parse_openapi_schema(), a tibblify spec. All references (⁠$ref⁠) in the spec are resolved.

Shortcomings

This implementation is not complete, and there are some known shortcomings:

• We only tibblify the paths part of the spec, although we also parse the components part in order to resolve references.

• We do not yet support summary or description fields in path item objects.

• We do not yet incorporate parameters defined at the path item level into operation-level parameter parsing. We do, however, parse and include them in the global_parameters column of the operations tibble, so they are available even though they are not yet merged into each operation's parameters.

• We do not yet support links in response objects.

• We do not yet support callbacks in operation objects.

• We do not yet support OpenAPI extensions (fields starting with ⁠x-⁠).

• Our implementation of oneOf, anyOf, and allOf is very basic and may not cover all cases.

Examples

file <- '{
  "$schema": "http://json-schema.org/draft-04/schema",
  "title": "Starship",
  "description": "A vehicle.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The name of this vehicle. The common name, e.g. Sand Crawler."
    },
    "model": {
      "type": "string",
      "description": "The model or official name of this vehicle."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The hypermedia URL of this resource."
    },
    "edited": {
      "type": "string",
      "format": "date-time",
      "description": "the ISO 8601 date format of the time this resource was edited."
    }
  },
  "required": [
    "name",
    "model",
    "edited"
  ]
}'
parse_openapi_schema(file)

# Spec example from
# https://swagger.io/docs/specification/v3_0/basic-structure/
spec_path <- system.file(
  "examples", "openapi", "sample_api.yaml", package = "tibblify"
)
spec <- parse_openapi_spec(spec_path)
spec

tibblify documentation built on May 9, 2026, 5:07 p.m.