Os AT URI e as ligações bsky.app, explicados
A gramática dos URI at:// para programadores: autoridade, NSID da coleção e chave do registo, a correspondência com as ligações bsky.app e a conversão em código.
O que um AT URI indica
Um AT URI aponta para uma conta ou para um registo do seu repositório. É o endereço que as apps e as API usam, onde as pessoas usam ligações bsky.app. A sua gramática, segundo a especificação dos AT URI:
at://AUTHORITY/COLLECTION/RKEY- Autoridade: a conta, como DID (
did:plc:…,did:web:…) ou como handle. Os registos são guardados por DID, por isso um URI guardado deve usar sempre o DID: um handle pode mudar de dono. - Coleção: o tipo de registo, um NSID como
app.bsky.feed.post. - Chave do registo (
rkey): o nome do registo na sua coleção. A maioria são TID, identificadores temporais como3l6oveex3ii2l; um perfil é sempreself.
at://did:plc:z72i7hdynmk6r22z27h6tvur é uma conta, at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post todas as suas publicações, e uma terceira parte indica uma publicação. Os registos que o conversor lê não têm consulta nem fragmento.
De bsky.app para at://, e de volta
A app do Bluesky dá uma página a cinco tipos de registos. O conversor faz a correspondência nos dois sentidos:
| Ligação bsky.app | AT URI |
|---|---|
/profile/{actor} | at://{did} |
/profile/{actor}/post/{rkey} | at://{did}/app.bsky.feed.post/{rkey} |
/profile/{actor}/feed/{rkey} | at://{did}/app.bsky.feed.generator/{rkey} |
/profile/{actor}/lists/{rkey} | at://{did}/app.bsky.graph.list/{rkey} |
/starter-pack/{actor}/{rkey} | at://{did}/app.bsky.graph.starterpack/{rkey} |
{actor} é um handle ou um DID: o bsky.app aceita os dois. Uma ligação com o DID nunca se quebra quando a conta muda de handle. Os registos de outras coleções (um gosto, um seguimento, um registo de outra app) não têm página em bsky.app: o conversor dá só o seu AT URI e as suas partes.
Para transformar um handle num DID, o conversor pergunta à AppView do Bluesky (com.atproto.identity.resolveHandle). Para mostrar uma ligação com o handle, lê o documento DID e só mantém o handle se este for resolvido para o mesmo DID.
Converter em código
Em TypeScript, AtUri de @atproto/syntax analisa e constrói os URI. Uma ligação de publicação passa a ser o seu URI assim:
import { AtUri } from "@atproto/syntax";
const COLLECTIONS: Record<string, string> = {
post: "app.bsky.feed.post",
feed: "app.bsky.feed.generator",
lists: "app.bsky.graph.list",
};
export function postLinkToAtUri(link: string, did: string): string {
const [, , kind, rkey] = new URL(link).pathname.split("/").filter(Boolean);
const collection = COLLECTIONS[kind];
if (!collection || !rkey) throw new Error("Not a post, feed or list link");
return AtUri.make(did, collection, rkey).toString();
}
const uri = new AtUri("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l");
uri.host; // the DID
uri.collection; // "app.bsky.feed.post"
uri.rkey; // "3l6oveex3ii2l"Em Python, o AT URI é simples o suficiente para ser dividido à mão:
def parse_at_uri(uri: str) -> dict:
if not uri.startswith("at://"):
raise ValueError("not an AT URI")
parts = uri[len("at://"):].split("/")
return {
"authority": parts[0],
"collection": parts[1] if len(parts) > 1 else None,
"rkey": parts[2] if len(parts) > 2 else None,
}Resolva primeiro o handle para um DID (resolveHandle, ou o localizador de DID) para que o URI que guarda continue a funcionar.
A partir da API ou de um agente de IA
O conversor também é GET /api/v1/tools/at-uri-converter?uri=… e a ferramenta MCP convert_at_uri: veja API das ferramentas e servidor MCP. Quando a chave do registo é um TID, o descodificador de TID lê a hora que contém.