Pet Store-POC

This repository demonstrates the functionalities of APIMatic’s Docs as Code Solution which allows users to provide all aspects of API Documentation as part of the code.

Visit the Published Portal.

How to Generate a Docs as Code Developer Portal:

The Portal Generation API creates Docs as Code Developer Portal. It is offered as a standalone solution that is completely independent of APIMatic’s web-based solution. This is an API-first solution and does not come with a GUI.

The Portal Generation API allows the entire Documentation Portal to be managed via a git repository. This includes API Specifications, Markdown Documentation, Configuration files, and static content referenced in the documentation such as images.

The Portal Generation API expects these files to be provided as a ZIP archive, with the following directory structure:

APIMATIC-BUILD.json
spec\
  openapi.json
content\
  guide1.md
  guide2.md
  toc.yml
  custom-section/
    section-overview.md
    toc.yml
static\
  images\
    img1.png
    img2.jpg
  another-static-file.txt

In addition to the above directory structure, the following constraints are also applied to the input ZIP archive:

• APIMatic expects a file with a name ending with APIMATIC-BUILD. Json file in the root directory. For details on the contents of this file, check out our documentation.
• The spec folder must contain at least one API specification. This can be in any of the API specification formats supported by APIMatic.
• content and static directories can be skipped if you do not have custom content or static files.

See this document for further information about the Portal Generation API and how it can be automated.

Features of APIMatic’s Docs as Code Portal:

Guided Walkthroughs:

With API Matic’s Guided Walkthroughs, your API documentation can now include step-by-step instructions to solve common use cases for developers. Through code samples and live try-it calls, developers get hands-on experience chaining a series of API calls to reach a business objective.

For a live demo of the feature click here.

Linking Published Packages:

Integrate popular package repositories like NuGet, Maven, and NPM into the portal, allowing users to download the source code seamlessly. See this detailed documentation to enable this functionality in your portal.

Integration of the Maven Package repository in the published portal:

Integration of the NuGet Package repository in the published portal:

Multiple Request Examples:

The Multiple Request Examples Feature allows API providers to illustrate different use cases with varied request payloads, significantly enhancing the Developer Portal. This feature enables developers to view diverse request body examples directly next to the designated operation, improving understanding and usability.

click here to view how the multiple request examples look in the published portal.

Support for OneOf and AnyOf Types:

In the Developer Portal, the OneOf and AnyOf properties support users to interact with different schema options as selectable choices, streamlining data modeling and validation within a unified interface.

click here to view how the OneOf and AnyOf Types look in the published portal.

Support for Custom HTML and CSS:

The Developer Portal supports custom CSS and HTML elements, including collapsible sections, buttons, and I-frames. This enhancement allows for personalized styling and the integration of interactive elements, enriching the user experience and providing greater flexibility in content presentation. Check the following documentation to add include stylesheet while generating the Developer Portal.

click here to view some sample HTML and CSS customizations in the published portal.