Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  •  Move into Public Knowledge Base

The manual import feature allows you to add a new RESTful API using an OpenAPI/Swagger document.

...

At this point, you should see the “Cloud Access” page with the diagram representing our services.

...

Image RemovedImage Added

Press the “Add source” button and select the “OpenAPI Definition“option in the list that appears.

...

You should now see the manual import wizard. Fill in the fields and press submit once ready. We recommend require that you validate the OpenAPI document before uploading it.

In order to fully analyze the API, the analyzers need to be able to make authenticated requests against the API. A dedicated set of credentials are expected, such as an API key. You’ll need to specify the precise query as CURL command in the wizard. The authentication process is decribed described in this article.

If the upload fails, Data Theorem’s support team will provide assistance and try to import the API on your behalf. We are made aware of import errors and will act on them as soon as we can, so no further action will be required on your part.

Please note that while the servers field is optional according to the OpenAPI specification, we do recommend require that you specify it on all the API definition definitions that you upload through this wizard.

...