ODD Platform
  • Overview
  • Architecture
  • ODDRN
  • Features
  • Use cases
    • Data compliance for Data Scientists
    • Deprecation for Data Engineer \ Analyst
    • Visibility for Data Quality Engineer
    • Data preparation for Visualization Engineer
    • Service Provider and Pre-Sales
  • Configuration and Deployment
    • Try locally
    • Deploy to Amazon Elastic Kubernetes Service (EKS)
    • Configure ODD Platform
    • Enable security
      • Authentication
        • Disabled authentication
        • Login form
        • OAUTH2/OIDC
        • LDAP
      • Authorization
        • Policies
        • Permissions
        • Roles
        • Owners
        • User-owner association
  • Developer Guides
    • API Reference
    • How to contribute
    • GitHub organization overview
    • Build and run
      • Build and run ODD Platform
      • Build and run ODD Collectors
Powered by GitBook
On this page
  • Overview
  • OpenAPI Specification
  • Using the Swagger UI
  • Interacting with the API via Swagger UI
  • Responses in Swagger UI
  • Further Information
Edit on GitHub
  1. Developer Guides

API Reference

OpenAPI Specification and Swagger UI

PreviousUser-owner associationNextHow to contribute

Last updated 1 year ago

Overview

This documentation provides a detailed guide on how to visualize and interact with the Open Data Discovery (ODD) API. It covers the usage of the OpenAPI Specification for understanding the API's structure and Swagger UI for testing and interacting with the API endpoints

OpenAPI Specification

The Platform has 2 distinct specifications that serve different aspects and both adhere to the OpenAPI Specification:

  1. Ingest specification: An open standards specification that unifies metadata formats and allows multiple data sources and participants of the data discovery landscape to exchange metadata effectively, transparently, and consistently. It describes the semantics of the data discovery process as we envision it. It is data source agnostic by design and is intentionally not tied to the specifics of any particular data source or data catalog. Reference to the description of the specification: .

  2. Platform specification: This specification outlines the available endpoints, request methods, response codes, and other necessary details to interact with objects within ODD Platform. The full OpenAPI Specification for the ODD API can be accessed at .

  • Learning Resource: For more in-depth knowledge about the OpenAPI, visit the .

Using the Swagger UI

You can utilize the Swagger UI for an interactive experience with the ODD API.

Swagger UI Access: The Swagger UI can be accessed on your deployed ODD platform at {platform-base-url}/api/v3/api-docs. Additionally, a demo version is available at .

Interacting with the API via Swagger UI

Select a definition: There are two definitions:

  • ingestion-api: describes all ingestion endpoints that are used by collectors.

  • platform-api: describes all endpoints for the ODD platform, that can be used to access ODD resources.

Start a Request: Navigate to an API endpoint in the Swagger UI and click "Try it out".

Enter Required Information: Ensure all mandatory fields (marked with an asterisk *) are completed.

Send the Request: Click the “Execute” button to submit the request.

Responses in Swagger UI

  • Response Body: The API response will be shown in the "Response body" section.

  • Response Codes and Examples: Examples of response objects for each response code can be found in the "Responses" section.

Further Information

Learn more about how to use Swagger UI with the .

Swagger UI documentation
https://github.com/opendatadiscovery/opendatadiscovery-specification/blob/main/specification/specification.md
GitHub Repository OpenAPI Specification
OpenAPI Resource Guide
ODD Platform Demo Swagger UI
Sample list of API Endpoints
Select a definition
Try it out
Filling required fields
Executing API Request
API Response Example