AT URI
AT URI is the addressing scheme used in the AT Protocol to reference repositories, collections, and individual records. Using the at:// scheme, these URIs provide a consistent way to identify and locate content within the ATmosphere.
AT URIs serve several functions within the AT Protocol. They are used to identify users accross the network, provide references during repository syncing, and standardized linking to AT Protocol content.
Applications typically display handle-based URIs for readability, but may use DID-based URIs internally for stability.
Structure
AT URIs follow a simple hierarchical structure:
at://{authority}/{collection}/{record-key}
Where:
authorityis either a handle (e.g.alice.bsky.social) or a Decentralized Identifier (e.g.did:plc:z72i7hdynmk6r22z27h6tvur)collectionis a Namespaced Identifier (NSID) specifying the type of content (e.g.app.bsky.feed.post)record-keyis a record key that uniquely identifies a record within the collection.
For example, these two URIs reference the same post:
at://alice.bsky.social/app.bsky.feed.post/3jzfcijpj2z2a
at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3jzfcijpj2z2a
URI Types
AT URIs can reference different levels of specificity.
Repository URIs reference an entire user repository:
at://alice.bsky.social
Collection URIs reference all records of a specific type in a repository:
at://alice.bsky.social/app.bsky.feed.post
Record URIs reference a specific individual record:
at://alice.bsky.social/app.bsky.feed.post/3jzfcijpj2z2a
Implementation Considerations
Usage of handles or DIDs in URIs depends on context. Handle-based URIs (at://alice.bsky.social/...) are human-readable but are not permanent. DID-based URIs (at://did:plc:z72i7hdynmk6r22z27h6tvur/...) are less readable, but provide stable, permanent references. For critical references, using DID-based URIs is recommended to ensure long-term stability.