인증
Bluesky의 인증은 App Password와 OAuth 두 가지입니다. 신규 구현에서는 OAuth 채택도 검토해 주세요.App Password
use Revolution\Bluesky\Facades\Bluesky;
$profile = Bluesky::login(
identifier: config('bluesky.identifier'),
password: config('bluesky.password'),
)->getProfile();
LegacySession을 사용합니다.
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Session\LegacySession;
Bluesky::login(identifier: config('bluesky.identifier'), password: config('bluesky.password'));
cache()->put('bluesky_legacy_session', Bluesky::agent()->session()->toArray(), now()->addDay());
Bluesky::withToken(LegacySession::create(cache('bluesky_legacy_session', [])));
if (! Bluesky::check()) {
Bluesky::refreshSession();
}
OAuth
Socialite로 취득한 토큰을OAuthSession으로 변환해서 사용합니다.
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Session\OAuthSession;
$session = OAuthSession::create(session('bluesky_session'));
$timeline = Bluesky::withToken($session)->getTimeline();
게시 작성
단순한 텍스트 게시
use Revolution\Bluesky\Facades\Bluesky;
$response = Bluesky::withToken()->post('test');
TextBuilder로 게시 조립
링크·태그·멘션을 올바르게 처리하려면TextBuilder를 사용합니다.
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\RichText\TextBuilder;
$post = TextBuilder::make(text: 'test')
->newLine()
->mention('@example.bsky.social')
->newLine()
->link('https://bsky.app/')
->newLine()
->tag('#Laravel')
->toPost();
$response = Bluesky::withToken()->post($post);
미디어 첨부
이미지 첨부
use Illuminate\Support\Facades\Storage;
use Revolution\Bluesky\Embed\Images;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
Bluesky::withToken();
$images = Images::create()->add(
alt: 'App screenshot',
blob: fn (): array => Bluesky::uploadBlob(
Storage::get('test.png'),
Storage::mimeType('test.png')
)->json('blob')
);
$post = Post::create(text: 'image post')->embed($images);
$response = Bluesky::post($post);
외부 링크 카드
use Revolution\Bluesky\Embed\External;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
$external = External::create(
title: 'Title',
description: 'Description',
uri: 'https://example.com'
);
$post = Post::create(text: 'external card')->embed($external);
$response = Bluesky::withToken()->post($post);
리플라이·인용
리플라이
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\Types\ReplyRef;
use Revolution\Bluesky\Types\StrongRef;
$reply = ReplyRef::to(
root: StrongRef::to(uri: 'at://', cid: 'cid'),
parent: StrongRef::to(uri: 'at://', cid: 'cid')
);
$post = Post::create(text: 'reply')->reply($reply);
$response = Bluesky::withToken()->post($post);
인용 게시
use Revolution\Bluesky\Embed\QuoteRecord;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\Types\StrongRef;
$quote = QuoteRecord::create(StrongRef::to(uri: 'at://', cid: 'cid'));
$post = Post::create(text: 'quote')->embed($quote);
$response = Bluesky::withToken()->post($post);
피드 취득
use Revolution\Bluesky\Facades\Bluesky;
$response = Bluesky::withToken()->getTimeline();
$items = $response->collect('feed');
use Revolution\Bluesky\Facades\Bluesky;
$feed = Bluesky::getAuthorFeed(actor: 'alice.bsky.social')->json('feed');
검색
use Revolution\Bluesky\Facades\Bluesky;
$response = Bluesky::withToken()->searchPosts(q: '#bluesky', limit: 10);
searchPosts()는 API 측의 일시적인 제한으로 인해, 미인증 액세스에서는 현재 이용할 수 없습니다.Source: docs/basic-client.md