Digitoo.ai

​OpenAPI Specification

Digitoo API supports the OpenAPI specification standard as a JSON object. It is a self-descriptive endpoint that enables developers to explore the API contract easily.

What is OpenAPI specification?

​URL

GET https://api.digitoo.ai/api-v2-json
http

​Response

The endpoint returns the OpenAPI specification. For example:

{
  "openapi": "3.0.0",
  "info": {
    "title": "My API",
    "version": "1.0.0",
    "description": "API documentation for My API"
  },
  "paths": { ... },
  "components": { ... }
}
json

​Helper Usages

​Using Postman

  1. Importing the OpenAPI Spec:

    • Open Postman.
    • Click on File > Import.
    • Choose the OpenAPI specification file you downloaded from /api-v2-json

  2. Generating Requests:

    • Postman will auto-generate endpoints and examples from the specification.
    • This allows you to quickly test various endpoints without manually crafting requests.

​Code Generation

Many code generation tools can use the OpenAPI specification to create client libraries automatically. Some popular options include:

  • Swagger Codegen: Generates client libraries, server stubs, and API documentation.
  • OpenAPI Generator: Offers a broad range of languages and customization options.

​Example (Using OpenAPI Generator):

openapi-generator-cli generate -i https://api.digitoo.ai/api-v2-json -g javascript -o ./client
bash

This command downloads the OpenAPI specification from the provided URL and generates a JavaScript client in the ./client directory.

​Additional Resources

This endpoint is designed to simplify API exploration and integration. Whether you use Postman, code generation tools, or other API testing tools, following these guidelines will help you make the most of your API specification.

AuthorizationExtracting data