Les AT URI et les liens bsky.app, expliqués
La grammaire des URI at:// pour les développeurs : autorité, NSID de collection et clé d’enregistrement, correspondance avec les liens bsky.app et conversion en code.
Ce que désigne une AT URI
Une AT URI désigne un compte ou un enregistrement de son dépôt. C’est l’adresse qu’utilisent les apps et les API, là où les gens utilisent des liens bsky.app. Sa grammaire, d’après la spécification des AT URI :
at://AUTHORITY/COLLECTION/RKEY- Autorité : le compte, sous forme de DID (
did:plc:…,did:web:…) ou de handle. Les enregistrements sont stockés par DID : une URI conservée devrait donc toujours utiliser le DID, car un handle peut changer de main. - Collection : le type d’enregistrement, un NSID comme
app.bsky.feed.post. - Clé d’enregistrement (
rkey) : le nom de l’enregistrement dans sa collection. La plupart sont des TID, des identifiants horodatés comme3l6oveex3ii2l; un profil a toujoursself.
at://did:plc:z72i7hdynmk6r22z27h6tvur est un compte, at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post tous ses posts, et une troisième partie désigne un post. Les enregistrements que lit le convertisseur n’ont ni requête ni fragment.
De bsky.app à at://, et retour
L’app Bluesky donne une page à cinq types d’enregistrements. Le convertisseur les fait correspondre dans les deux sens :
| Lien 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} est un handle ou un DID : bsky.app accepte les deux. Un lien avec le DID ne casse jamais quand le compte change de handle. Les enregistrements des autres collections (un like, un abonnement, un enregistrement d’une autre app) n’ont pas de page bsky.app : le convertisseur donne seulement leur AT URI et ses parties.
Pour transformer un handle en DID, le convertisseur interroge l’AppView de Bluesky (com.atproto.identity.resolveHandle). Pour afficher un lien avec le handle, il lit le document DID et ne garde le handle que s’il est résolu vers le même DID.
Convertir en code
En TypeScript, AtUri de @atproto/syntax analyse et construit les URI. Un lien de post devient son URI ainsi :
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"En Python, l’AT URI est assez simple pour être découpée à la main :
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,
}Résolvez d’abord le handle en DID (resolveHandle, ou l’outil Trouver un DID) pour que l’URI que vous conservez continue de fonctionner.
Depuis l’API ou un agent d’IA
Le convertisseur est aussi GET /api/v1/tools/at-uri-converter?uri=… et l’outil MCP convert_at_uri : voir API des outils et serveur MCP. Quand la clé d’enregistrement est un TID, le décodeur de TID lit l’heure qu’il contient.