Getting Started

Identifiers

How content, channels, and playlists are addressed in the Rad TV API.

Every resource in the Rad TV API has a unique DID (Decentralized Identifier). You'll use DIDs whenever you query, create, or modify content.

DID Format

did:rad.live:<type>/<subtype>:<id>

Common Types

ResourceFormatExample
Channeldid:rad.live:channel/<id>did:rad.live:channel/a1b2c3d4
Feature (video)did:rad.live:content/feature/<id>did:rad.live:content/feature/123
Playlistdid:rad.live:content/playlist/<id>did:rad.live:content/playlist/456
Episodedid:rad.live:content/episode/<id>did:rad.live:content/episode/789
Seriesdid:rad.live:content/serie/<id>did:rad.live:content/serie/101
Streamdid:rad.live:content/stream/<id>did:rad.live:content/stream/303
Categorydid:rad.live:content/category/<id>did:rad.live:content/category/505

Where DIDs Appear

DIDs are returned from every API call and used as input to identify resources:

Creating content returns a DID:

mutation {
  createContent(input: { metadata: { title: "My Video" } }) {
    id  # → did:rad.live:content/feature/123
  }
}

Use that DID in follow-up calls:

mutation {
  publishContent(id: "did:rad.live:content/feature/123") {
    id
    metadata { title }
  }
}

Your channel DID is on the me query:

{
  me {
    channel {
      id  # → did:rad.live:channel/a1b2c3d4
      metadata { name }
    }
  }
}

The DID Scalar Type

In the GraphQL schema, DID is a custom scalar type. Fields typed as DID! always contain a valid identifier string. You can use them directly in queries and mutations.

Next steps

  • Quickstart — Make your first API call using DIDs
  • Workflows — See end-to-end workflows that create and manage content

On this page