Comprendre les dépôts AT Protocol
Dépôts, collections, clés, CID et fichiers : les données lues par l’explorateur, les protections des requêtes et l’export des données d’un compte.
Dépôts et collections
Le serveur de données personnel (PDS) d’un compte héberge son dépôt public. Les collections regroupent les données par NSID de schéma : app.bsky.feed.post contient les posts, app.bsky.graph.follow les abonnements. Un NSID inconnu désigne un autre schéma, pas forcément Bluesky.
L’explorateur de dépôt accepte un handle, un DID ou une URI AT. Le dépôt liste les collections ; chacune affiche 50 enregistrements par page dans les deux ordres. Les URL utilisent q, cursor et reverse=1, pour naviguer aussi sans JavaScript.
Clés, CID et références
Une URI AT désigne le dépôt, la collection et la clé. Un CID identifie une version du contenu. De nombreuses clés sont des TID contenant une date ; d’autres, dont self, n’en ont pas. Voir le convertisseur d’URI AT et le décodeur TID.
L’arborescence JSON échappe le texte et se limite à 256 Kio et 20 niveaux. Les références AT mènent aux enregistrements, les DID au Whois. Les références de fichiers indiquent CID, type MIME et taille. Le téléchargement est un lien externe explicite vers le PDS ; aucune image d’un PDS arbitraire n’est chargée automatiquement.
Lecture publique et protections
L’outil résout le document DID, vérifie le relais et appelle com.atproto.repo.describeRepo, com.atproto.repo.listRecords ou com.atproto.repo.getRecord sur le PDS. Chaque requête utilise la protection SSRF, HTTPS, un délai de quatre secondes, aucune redirection et une limite de 1 Mio, ou 256 Kio pour un enregistrement. Les adresses privées sont refusées. Le cache dure cinq minutes, une minute pour les collections. Aucune écriture.
Exporter et ouvrir localement
Dans Bluesky : Paramètres → Compte → Exporter mes données. Les développeurs peuvent télécharger com.atproto.sync.getRepo?did=… directement sur leur PDS. Ouvrez le .car obtenu dans l’explorateur CAR. Il fonctionne dans un worker local, sans envoi, API, interface MCP ni statistiques liées au fichier. Suivez une référence seulement pour naviguer ailleurs.
Les exports CAR v1 sont limités à 512 Mio, 250 000 enregistrements, 500 000 sections doublons compris et 2 000 collections. Les en-têtes sont limités à 64 Kio et les blocs à 1 Mio avant accumulation de leur contenu. Un budget distinct de 512 Mio comptabilise les blocs conservés et les métadonnées de l’index reconstruit. Le worker lit des tranches de 64 Kio, hache chaque bloc distinct une fois et vérifie l’égalité des doublons. Chaque opération locale est limitée à 60 secondes ; annuler une lecture réutilise le worker déjà chargé, sans requête réseau. Collections et enregistrements sont paginés par 100. La mémoire disponible peut imposer une limite pratique inférieure. Une signature présente reste non vérifiée. Recherche et JSON Lines restent locaux ; ZIP et export massif de blobs sont exclus.