From ddf1ceeee828f7306175a3269b67fd09a0c50e14 Mon Sep 17 00:00:00 2001 From: kawax Date: Mon, 25 Nov 2024 08:17:06 +0900 Subject: [PATCH] Update basic-client.md --- docs/basic-client.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/docs/basic-client.md b/docs/basic-client.md index 158e3627..5cfa89be 100644 --- a/docs/basic-client.md +++ b/docs/basic-client.md @@ -487,6 +487,41 @@ $profile = Bluesky::getProfile(actor: 'did')->json(); $feed = Bluesky::getAuthorFeed(actor: 'did')->json('feed'); ``` +The request content will automatically change depending on whether you are authenticated or not. To explicitly use the public API, use `logout()`. + +```php +use Revolution\Bluesky\Facades\Bluesky; + +// public requests +$profile = Bluesky::getProfile(actor: 'did')->json(); + +// authed requests +Bluesky::login(); +$profile = Bluesky::getProfile(actor: 'did')->json(); +// The DID of the authed user is set automatically. +$profile = Bluesky::getProfile()->json(); + +// public requests +Bluesky::logout(); +$profile = Bluesky::getProfile(actor: 'did')->json(); +``` + +There are some APIs whose responses change slightly depending on the authentication state. + +```php +use Revolution\Bluesky\Facades\Bluesky; + +// authed +$profile = Bluesky::login()->getProfile(actor: 'did')->json(); +// has "viewer" +dump($profile['viewer']); + +// public +$profile = Bluesky::logout()->getProfile(actor: 'did')->json(); +// no "viewer" +dump($profile['viewer']); +``` + ## Macroable ```php