メインコンテンツへスキップ

​
概要

Bluesky では Handle、DID などの相互解決が頻繁に必要になります。

​
Handle から DID を解決する

​
API 経由

use Revolution\Bluesky\Facades\Bluesky;

$did = Bluesky::resolveHandle('***.bsky.social')->json('did');

​
DNS/well-known 経由

DNS TXT レコードまたは /.well-known/atproto-did を確認します。 
use Revolution\Bluesky\Facades\Bluesky;

$did = Bluesky::identity()->resolveHandle('alice.test');
2つは似ていますが動作が異なります。API 経由はネットワーク越しに Bluesky サービスへ問い合わせるのに対し、DNS/well-known 経由はカスタムドメインの Handle 解決に適しています。

​
DID から DID Document を取得する

resolveDID は DID Document を返します。 https://plc.directory/did:plc:ewvi7nxzyoun6zhxrhs64oiz 
use Revolution\Bluesky\Facades\Bluesky;

$didDoc = Bluesky::identity()->resolveDID('did:plc:*** または did:web:***')->json();

​
DID Document から Handle を取得する

DID Document の alsoKnownAs フィールドに Handle が含まれています。 
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveDID('did:plc:*** または did:web:***')->json());
$handle = $didDoc->handle();

​
resolveIdentity による統合解決

resolveHandle と resolveDID を組み合わせた resolveIdentity を使うと、DID または Handle のどちらからでも解決でき、DID Document を返します。 
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveIdentity('did または handle')->json());
$didDoc->id();
$didDoc->handle();

​
公開プロフィールの取得

公開プロフィールは DID または Handle のどちらからでも解決でき、レスポンスに DID と Handle の両方が含まれます。 
use Revolution\Bluesky\Facades\Bluesky;

$profile = Bluesky::getProfile('did または handle');
$profile->json('did');
$profile->json('handle');

​
PDS URL / serviceEndpoint の取得

DID Document の serviceEndpoint は PDS の URL です。直接使用することは少ないですが、必要に応じて取得できます。 
https://***.***.host.bsky.network

use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveIdentity('did または handle')->json());
$didDoc->pdsUrl();

​
Authorization Server URL の取得

PDS を経由して Authorization Server の URL を解決します。 Bluesky に登録したアカウントの場合、通常は https://bsky.social になります。 
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Support\DidDocument;

$didDoc = DidDocument::make(Bluesky::identity()->resolveIdentity('did または handle')->json());

$pds = Bluesky::pds()->getProtectedResource($didDoc->pdsUrl());
$pds->authServer();
Source: docs/identity.md
最終更新日 2026年4月24日