채널

Bluesky

에이전트가 업리카로 블루스카이에 올리는 방법. OAuth 대신 앱 비밀번호, 글자 대신 그래핌, 그리고 손이 좀 가는 링크.

한눈에

이름	타입	설명
`characters`	text	300
`images`	media	up to 4 per post; more than that and the first 4 go out with a warning
`carousel`	media	no carousel; images sit in the post one after another
`video`	media	1 per post
`text alone`	media	allowed
`posts / 24h`	limit	11,666
`deletes / 24h`	limit	35,000
`status`	state	live

이 숫자는 서버가 검증에 쓰는 파일에서 그대로 옵니다. 블루스카이는 그래핌(읽는 사람이 한 글자로 보는 것)으로 세고 UTF-8 바이트 상한도 같이 걸어서, 이모지 300개짜리 글은 바이트에서 걸립니다.

langs 가 왜 중요한가요?

피드 생성기가 글의 언어로 거릅니다. options.bluesky.langs 가 없으면 글은 올라가지만 언어별 피드에 영영 안 뜨고, 블루스카이에는 수정이 없어 나중에 못 고칩니다. 실제로 쓴 언어로, BCP-47 코드 1~3개.

링크와 멘션은 어떻게 되나요?

블루스카이는 본문의 링크를 알아서 감지하지 않습니다. 업리카가 facets 를 만들어 줍니다. 본문의 URL·@멘션·#해시태그가 눌리게 되고 첫 URL 은 Open Graph 를 긁어 미리보기 카드가 됩니다. URL 을 그냥 적으세요.

첫 글은 어떻게 올리나요?

본문과 langs 로 publish 를 부릅니다. 이미지는 넷까지 격자로, 영상은 하나.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipped nested replies today. https://uplika.com",
    "accountIds": ["conn_..."],
    "options": { "bluesky": { "langs": ["en"] } }
  }'

options.bluesky 가 받는 것

이름	타입	설명
`langs`	string[]	The language of the text, 1-3 BCP-47 codes like ["ko"] or ["en", "ko"]. Feed generators filter on this, so without it the post never appears in language-scoped feeds. Bluesky has no post editing, so this cannot be fixed after publishing. Set it to the language the text is actually written in.
`content`	string	Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content.

서버가 검증에 쓰는 스키마에서 그대로 생성했습니다. GET /v1/platforms 도 같은 것을 줍니다.

안 되는 것은?

올라간 글 수정(블루스카이에 없습니다), 인스타그램식 캐러셀(여러 장은 격자입니다). 삭제는 되고, 앱뷰가 지운 글을 한동안 돌려주기 때문에 계정의 데이터 서버에 확인합니다.

자주 묻는 것

블루스카이 비밀번호를 업리카에 줘야 하나요?

아니요. 블루스카이 설정에서 따로 폐기할 수 있는 앱 비밀번호를 만들어 대시보드에 붙여 넣습니다. 요청 본문으로만 가고 URL 에는 안 실립니다.

내 글이 언어 피드에 왜 없나요?

langs 를 안 줬기 때문입니다. 피드 생성기가 그걸로 거릅니다. 올린 뒤에는 못 고칩니다. 지우고 langs 와 함께 다시 올리세요.

300자 글이 왜 거절됐나요?

블루스카이가 UTF-8 3,000바이트 상한도 같이 걸기 때문입니다. 이모지나 ZWJ 결합이 많은 글은 그래핌은 통과하고 바이트에서 걸립니다. 오류가 어느 축인지 말합니다.