Export data
Apidog supports exporting APIs in data formats such as OpenAPI Specification
, HTML
, Markdown
, Apidog
.
Export Data
Navigate to the "Settings" → "Export Data" option in the left menu bar, select your preferred data format, and click the "Export" button.
You have the flexibility to export all APIs at once or select specific APIs for export.
Exporting can also be organized by tags to target specific grouped APIs.
For the OpenAPI Specification
, we support versions 3.1
, 3.0
, and Swagger 2.0
. Exports can be performed in YAML
or JSON
formats, incorporating the Apidog Extension OpenAPI Field and organizing exports using the Tags field as folders.
Additionally, it's possible to export the data as an offline document. Click "Open URL" to access and view the RAW content directly in your browser.
OperationID
OperationId
is a unique identifier used to distinctly identify an API operation in the OpenAPI specifications. When exporting in the OpenAPI
format, the OperationId
attribute can be set, and this identifier will be included in the exported OperationId
of the Operation object.
FAQ
Q: Why have the number of exported APIs decreased?
A: This may occur when multiple APIs use the same method and path. HTML and Markdown are exported via OpenAPI data conversion, which does not support multiple APIs sharing the same methods and paths.
Q: Why is the API order disorganized when exported to Markdown and HTML?
A: The Swagger specification, which is a part of OpenAPI, lacks explicit support for ordering or grouping APIs. As a result, Markdown and HTML exports might appear unorganized. For orderly exports, consider using Apidog’s native format.
Q: Why do the numbers of exported APIs decrease when multiple APIs have the same URL?
A: The OpenAPI specification does not allow multiple APIs to share the same method and path. Ensure each API uses a unique URL. For further details on ensuring unique API identifiers, refer to Endpoint unique idenfication. Both HTML and Markdown exports are conducted through OpenAPI and are subjected to the same restrictions.
Q: How can I export to PDF?
A: Direct exports to PDF or Word are currently unsupported by Apidog. However, you can export your data in Markdown format first and then use external tools to convert it to the desired format. Typora, for instance, can convert Markdown into PDF, Word, OpenOffice, Epub, and other formats.
Q: Why was only one API exported successfully out of several?
A:
- Ensure that no multiple APIs use the same method and path.
- OpenAPI specifications prohibit different APIs from sharing identical method and path configurations. Consult Endpoint unique idenfication for more information.
- Note that translating to HTML or Markdown via OpenAPI data can cause issues.
Q: How to Export Authentication Values?
A: Apidog automatically exports Auth
values within the Swagger format files. No additional setup is required. To locate these values, check the securitySchemes
section in the Swagger format file.