API Overview

The Media Registry provides a comprehensive API for programmatic access to media, content, creators, and related data. Built on the Helix Platform and Cubi Cube framework, this API enables seamless integration with other Voyager Suite components, third-party platforms, and automated workflows.

Authentication

API endpoints leverage the Cubi Cube's enterprise-grade authentication system with API keys and OAuth support. Access control is enforced based on user roles and permissions, ensuring secure integration across the Voyager Suite ecosystem.

API Endpoints

  • GET /api/media – List all media entities
    Returns: Array of media entity records
  • GET /api/media/:id – Retrieve a specific media entity by ID or DID
    Returns: Media entity record
  • GET /api/content – List all content entities
    Returns: Array of content entity records
  • GET /api/content/:id – Retrieve a specific content entity
    Returns: Content entity record
  • GET /api/creators – List all creators
    Returns: Array of creator records
  • GET /api/creators/:id – Retrieve a specific creator
    Returns: Creator record
  • GET /api/splitsheets/:contentId – Get split sheet for a content entity
    Returns: Array of split sheet records
  • POST /api/media – (Planned) Add a new media entity
  • POST /api/content – (Planned) Add a new content entity
  • POST /api/creators – (Planned) Add a new creator
  • POST /api/splitsheets – (Planned) Add or update split sheet information

Example: Retrieve Media Entity

GET /api/media/did:webvh:did.ocmeregistry.com:media:unique-id

Response:
{
  "did": "did:webvh:did.ocmeregistry.com:media:unique-id",
  "file_hash": "...",
  "format": "mp4",
  "resolution": "1080p",
  "codec": "H.264",
  "storage_path": "...",
  "created_at": "...",
  "updated_at": "..."
}
  

Implementation Status

The API is currently in active development as part of the Voyager Suite ecosystem. This documentation reflects the intended API design and will be updated as features are released. Future enhancements will include deeper integration with Home Base, Moon Base, and other Voyager Suite components.