Quick Start

Installation

You can install the package with composer:

composer require shahmal1yev/blueskysdk:"^1@beta"

Authentication

Authenticate to BlueSky easily with your credentials.

use Atproto\Client;

$client = new Client();
$client->authenticate(getenv('BLUESKY_IDENTIFIER'), getenv('BLUESKY_PASSWORD'));

Save and Restore Sessions

Export the session for later use:

$saveToDatabase(json_encode($client->authenticated()));

Restore it when needed:

use Atproto\Responses\Com\Atproto\Server\CreateSessionResponse;

$savedSession = new CreateSessionResponse(json_decode($savedSessionJSON, true));

$client = new Client();
$client->authenticate(getenv('BLUESKY_IDENTIFIER'), getenv('BLUESKY_PASSWORD'), $savedSession);

Note

More on Session Management

Making a Request

Use the BskyFacade for clean and concise API requests:

$profile = bskyFacade($client)->getProfile()
    ->actor($client->authenticated()->handle())
    ->send();

echo $profile->displayName(); // Type-safe response

Casting Example

Access response data with type casting:

/** @var \Carbon\Carbon $createdAt */
$createdAt = $profile->createdAt();

Note

Learn more about Casting

---

Full Example

$session = new CreateSessionResponse(json_encode(/* session json */, true));
$client = new Client('identifier', 'password', $session);

$profile = bskyFacade($client)->getProfile()
    ->actor($client->authenticated()->handle())
    ->send();

$createdAt = $profile->createdAt();

Note

More Examples