채널

Ghost

에이전트가 업리카로 Ghost 블로그에 올리는 방법. 통합 키, 사진이 든 마크다운, 초안과 수정.

한눈에

이름	타입	설명
`characters`	text	30,000
`images`	media	up to 40 per post; more than that and the first 40 go out with a warning
`carousel`	media	no carousel; images sit in the post one after another
`video`	media	not supported
`text alone`	media	allowed
`posts / 24h`	limit	1,000
`deletes / 24h`	limit	Ghost through the Admin API, with no documented daily cap or time limit
`status`	state	live

이 숫자는 서버가 검증에 쓰는 파일에서 그대로 옵니다. 제목은 필수이고 코드포인트로 셉니다. 사진만 올라갑니다.

본문은 어떻게 Ghost 에 가나요?

마크다운이고 Ghost 가 쓴 대로 그립니다. 사진은 한 줄에 하나씩 ![설명](media:<id>) 으로 넣고, 업리카가 Ghost 사이트에 복사합니다. @group 이나 {.small} 같은 네이버 블로그 문법은 거절합니다.

첫 글은 어떻게 올리나요?

마크다운 본문과 options.ghost.title 로 publish 를 부릅니다. Ghost 초안으로 두려면 options.ghost.draftOnly 를 더합니다.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Intro.\n\n![Cover](media:med_...)",
    "accountIds": ["conn_..."],
    "options": { "ghost": { "title": "Release notes", "tags": ["news"] } }
  }'

options.ghost 가 받는 것

이름	타입	설명
`title`필수	string	Required. The post title, up to 255 characters.
`tags`	string[]	Tag names; Ghost creates new ones. A name starting with # is refused (Ghost would make it a hidden internal tag). On an edit, leave it out to keep the current tags.
`featureImageMediaId`	string	Media id of a JPEG, PNG, GIF or WebP for the feature image; Uplika uploads a copy to Ghost. On an edit, leave it out to keep the current one.
`draftOnly`	boolean	Save it as a Ghost draft instead of publishing; the permalink is then its Ghost editor page. Not the same as draft on the post, which keeps it on Uplika.
`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 도 같은 것을 돌려줍니다.

안 되는 것은?

뉴스레터 메일. 업리카는 보내지 않고 글은 사이트에만 올라갑니다. 회원 전용 글, 영상, 댓글, 조회수는 내지 않습니다. update_post 는 글을 제자리에서 다시 쓰고, 보내지 않은 태그와 대표 이미지는 그대로 둡니다.

자주 묻는 것

글쓴이는 누구로 나오나요?

통합 키로 쓴 글은 Ghost 가 사이트 소유자를 글쓴이로 둡니다. 스태프 액세스 토큰을 쓰면 그 사람으로 올라갑니다.

연결하면 API URL 이 틀렸다고 나와요

공개 사이트 주소가 아니라 커스텀 통합에 보이는 API URL 을 넣으세요. Ghost(Pro) 에서는 사이트가 자기 도메인을 써도 .ghost.io 로 끝납니다.

누가 Ghost 에서 같은 글을 고치고 있으면요?

업리카가 한 번 다시 읽고 다시 씁니다. 그래도 고치는 중이면 update_post 는 덮지 않고 ghost_update_collision 으로 실패합니다.