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
| Resource | Format | Example |
|---|---|---|
| Channel | did:rad.live:channel/<id> | did:rad.live:channel/a1b2c3d4 |
| Feature (video) | did:rad.live:content/feature/<id> | did:rad.live:content/feature/123 |
| Playlist | did:rad.live:content/playlist/<id> | did:rad.live:content/playlist/456 |
| Episode | did:rad.live:content/episode/<id> | did:rad.live:content/episode/789 |
| Series | did:rad.live:content/serie/<id> | did:rad.live:content/serie/101 |
| Stream | did:rad.live:content/stream/<id> | did:rad.live:content/stream/303 |
| Category | did: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