게시 연동
Ghost
최종 업데이트:
커스텀 Admin API 연동으로 Ghost를 연결하고, 가장 흔한 실수인 Content API 키 혼동을 피하는 방법을 안내해요.
Clodix는 Ghost의 Admin API를 사용해 아티클을 Ghost 사이트에 바로 게시해요.
커스텀 연동 만들기
- Ghost Admin에서 Settings → Integrations로 이동하세요.
- Add custom integration을 클릭하세요.
- "Clodix"처럼 알아보기 쉬운 이름을 붙이세요.
- Ghost가 Admin API Key와 Content API Key, 두 개의 키를 보여 줘요. 필요한 것은 Admin API Key예요.
- 같은 화면에 표시된 Admin API URL(사이트 주소, 예:
https://yourblog.ghost.io)을 복사하세요.
Clodix에서 연결하기
- Settings → Publishing integrations를 열고 Ghost를 클릭하세요.
- 다음을 입력하세요.
- Admin API URL — 사이트 주소.
- Admin API Key —
id:secret형식의 키(가운데에 콜론이 있는 긴 문자열).
- Connect를 클릭하세요. Clodix가 저장하기 전에 사이트에서 키를 실시간으로 확인해요.
게시된 포스트는 이렇게 보여요
- 아티클이 Ghost 포스트로 만들어져 바로 게시되며, 제목, 본문, 요약문, 메타 설명이 함께 들어가요.
- 커버 이미지는 포스트의 대표 이미지(feature image)로 설정돼요.
- 나중에 아티클을 수정하고 다시 게시하면 같은 Ghost 포스트가 업데이트돼요. Clodix는 사본을 따로 만들지 않아요.
- Unpublish를 하면 Ghost에서 포스트가 Draft로 되돌아가요. 삭제되는 것은 없어요.
자주 발생하는 문제
| 메시지 | 의미 | 해결 방법 |
|---|---|---|
| "Admin API key looks wrong" | 키가 예상 형식인 id:secret과 맞지 않아요. 대개 Content API Key를 대신 붙여 넣은 경우예요. | Ghost에서 Settings → Integrations → [your integration]으로 돌아가 Admin API Key를 복사하세요. |
| "Ghost rejected the Admin API key" | 키를 잘못 복사했거나, Ghost 쪽에서 커스텀 연동이 삭제되었어요. | 필요하면 Ghost에서 연동을 다시 만들고 Admin API Key를 다시 복사하세요. |
| "Couldn't reach the Ghost Admin API" | Admin API URL이 잘못되었거나 사이트가 오프라인이에요. | Ghost의 연동 화면에 표시된 URL을 다시 확인하세요. |
| "This address isn't reachable from Clodix" | URL이 로컬 또는 사설 네트워크를 가리키거나, 비표준 포트(예: :2368)가 붙어 있어요. | 포트 없이 https를 사용하는 Ghost 사이트의 공개 주소를 사용하세요. |
FAQ
Clodix가 내 Ghost 회원이나 구독을 볼 수 있나요?
아니요. 커스텀 연동은 Admin API를 통해 포스트에 대한 접근만 허용해요. Ghost 사이트의 회원, 구독, 결제와는 관련이 없어요.
같은 연동을 Ghost의 다른 용도로도 사용할 수 있나요?
가능하지만, 용도를 한눈에 알아볼 수 있고 필요할 때 그 연동만 폐기할 수 있도록 전용 "Clodix" 연동을 따로 만드는 것을 권장해요.