at.eptss.trackLink

eptss.at

Documentation

An assertion that a track plays at a URL, written by anyone, about any track, and never editing the track it is about. There is at least one of these per platform per song, which is exactly why the URL cannot live on the track itself. Prefer a deterministic rkey so re-running an importer upserts instead of piling up.

main record

An assertion that a track plays at a URL, written by anyone, about any track, and never editing the track it is about. There is at least one of these per platform per song, which is exactly why the URL cannot live on the track itself. Prefer a deterministic rkey so re-running an importer upserts instead of piling up.

Record Key any Any valid record key

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

service string Optional

Base domain the url belongs to — 'open.spotify.com', 'music.apple.com', 'bandcamp.com'. A domain and never an enum: a new service must cost zero schema changes.

maxLength: 253 bytes
url string uri Required

Raw, exactly as encountered — query string and all. Stripping is a guess, and a guess in a record is permanent; normalize in the index, which is the only part that can be re-run.

View raw schema 
{
  "key": "any",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "track",
      "url",
      "createdAt"
    ],
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "description": "Raw, exactly as encountered — query string and all. Stripping is a guess, and a guess in a record is permanent; normalize in the index, which is the only part that can be re-run."
      },
      "track": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "The at.eptss.track this link locates."
      },
      "service": {
        "type": "string",
        "maxLength": 253,
        "description": "Base domain the url belongs to — 'open.spotify.com', 'music.apple.com', 'bandcamp.com'. A domain and never an enum: a new service must cost zero schema changes."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      }
    }
  },
  "description": "An assertion that a track plays at a URL, written by anyone, about any track, and never editing the track it is about. There is at least one of these per platform per song, which is exactly why the URL cannot live on the track itself. Prefer a deterministic rkey so re-running an importer upserts instead of piling up."
}

Lexicon Garden

@