跳转到主要内容

概览

在 Bluesky 中,经常需要在 Handle、DID 之间进行相互解析。

从 Handle 解析 DID

通过 API

通过 DNS / well-known

从 DNS TXT 记录或 /.well-known/atproto-did 中获取。
两者看似相似,但行为不同。API 方式会通过网络向 Bluesky 服务查询,而 DNS/well-known 方式则更适合解析自定义域名的 Handle。

从 DID 获取 DID Document

resolveDID 会返回 DID Document。 https://plc.directory/did:plc:ewvi7nxzyoun6zhxrhs64oiz

从 DID Document 获取 Handle

DID Document 的 alsoKnownAs 字段中包含 Handle。

使用 resolveIdentity 统一解析

resolveIdentity 结合了 resolveHandleresolveDID,无论传入 DID 还是 Handle 都能进行解析,并返回 DID Document。

获取公开个人资料

公开个人资料无论从 DID 还是 Handle 都可以解析,响应中会同时包含 DID 和 Handle。

获取 PDS URL / serviceEndpoint

DID Document 中的 serviceEndpoint 就是 PDS 的 URL。虽然直接使用的情况不多,但你可以按需获取。

获取 Authorization Server URL

通过 PDS 解析出 Authorization Server 的 URL。 对于在 Bluesky 注册的账号,一般是 https://bsky.social
最后修改于 2026年7月18日