Documentação da ferramenta

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:

text
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 como 3l6oveex3ii2l; um perfil é sempre self.

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.appAT 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:

ts
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:

py
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.

Conversor de AT URI

De uma ligação bsky.app para um URI at://, e de volta.