import-api-spec

Generate API documentation from OpenAPI and GraphQL specs by placing your YAML or JSON files in a folder and running the import process to validate syntax, resolve $ref references, and output a standardized api-reference directory.

Consolidating multiple vendor API specs involves importing and classifying files by type, extracting servers and security mappings, and generating a coherent documentation scaffold with introduction, authentication, and error sections.

Yes, you can import AsyncAPI specifications alongside OpenAPI files. The process detects the spec type by file patterns and applies syntax validation, server extraction, and authentication mappings across common spec formats.

$ref resolution works during spec ingestion by parsing the JSON or YAML files, validating the syntax, resolving internal references, and extracting endpoints and security schemes to produce ready-to-publish documentation.

Supported file formats for importing API specifications include JSON and YAML, accommodating common spec formats such as openapi.yaml, swagger.yaml, schema.graphql, and asyncapi.yaml.

Yes, the API spec import process handles authentication and security mappings by extracting security schemes from the specifications and generating dedicated authentication sections in the standardized documentation scaffold.