Skip to main content

概觀

在 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 統合解析

使用結合 resolveHandleresolveDIDresolveIdentity,可從 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年8月2日