Bluesky API Kurulumu
Bluesky OAuth app yerine app password kullanır, dolayısıyla yapılandırılacak developer-portal credentials yoktur. Her son-kullanıcı kendi handle + app password'ünü /app/channels'tan girer.
/admin/api-integration/bluesky admin formu yalnızca self-hosted PDS dağıtımları için varsayılan Bluesky service URL'sini override etmeye yarar.
Genel bakış
| Form alanı | Options anahtarı | Varsayılan |
|---|---|---|
| Service URL | bluesky_service-url | https://bsky.social |
| Status | bluesky_integration_status | enabled |
ENV fallback: BLUESKY_SERVICE_URL (varsayılan https://bsky.social).
Bir şey değiştirmen gereken durumlar
Dağıtımların %99'unda Service URL'i boş bırak — Sosyabot public https://bsky.social Personal Data Server'a (PDS) varsayılanır. Yalnızca tenant'ların self-hosted PDS'e veya fork edilmiş AT-Protocol instance'ına bağlanırsa override et.
Son-kullanıcılar ne yapar
Son-kullanıcılar:
- https://bsky.app/settings/app-passwords'ta app password oluştur.
/app/channels→ Connect → Bluesky'yi aç.- Handle (
you.bsky.social) ve app password'ü yapıştır.
Sosyabot burada yapılandırılan Service URL'e karşı com.atproto.server.createSession çağırır. OAuth tur-dönüşü yoktur.
Kullanıcı tarafı akışı için Bağlantılar → Bluesky'e bak.
Sosyabot admin paneline yapıştırma
/admin/api-integration/bluesky:
- Service URL: varsayılan için boş bırak; veya PDS origin'ini yapıştır (trailing slash yok, örn.
https://pds.example.com). - Status: Enable.
- Save.
Test butonu yoktur — bağlantı app password gönderildiğinde kullanıcı başına doğrulanır.
Sorun giderme
| Belirti | Sebep | Çözüm |
|---|---|---|
Tüm bağlantılar Invalid identifier or password ile başarısız | Service URL kullanıcının kimliğini barındırmayan PDS'e işaret ediyor | Çoğu kullanıcı public PDS'te yaşar; Service URL'i varsayılana sıfırla. |
| App password bağlantı başarılı ama gönderim başarısız | App password gerekli scope'tan yoksun olabilir (Bluesky app password'leri sınırlı) | Kullanıcı bsky.app/settings/app-passwords'ta app password'ü yeniden üretsin. |
ENV fallback
BLUESKY_SERVICE_URL=https://bsky.social.env düzenledikten sonra ./service.sh restart api.