公開連携
Ghost
最終更新日：
カスタムのAdmin API連携でGhostを接続する方法と、最もよくある取り違え（Content APIキー）の回避方法を説明します。
Clodixは、GhostのAdmin APIを使って、記事をGhostサイトに直接公開します。
カスタム連携を作成する
- Ghost Adminで Settings → Integrations に進みます。
- Add custom integration をクリックします。
- 「Clodix」など、分かりやすい名前を付けます。
- Ghostに2つのキー（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の投稿として作成され、タイトル、本文、抜粋、メタディスクリプションとともにすぐに公開されます。
- カバー画像は、投稿のフィーチャー画像として設定されます。
- あとから記事を編集して再公開すると、同じGhostの投稿が更新されます。 Clodixが2つ目のコピーを作ることはありません。
- 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）が含まれています。 | ポート番号なしで、Ghostサイトの公開アドレス（https）を使用します。 |
FAQ
ClodixからGhostのメンバーやサブスクリプションは見えますか？
いいえ。カスタム連携が許可するのは、Admin APIを通じた投稿へのアクセスだけです。Ghostサイトのメンバー、サブスクリプション、課金とは関係ありません。
同じ連携をGhostの他の用途にも使えますか？
使えますが、「Clodix」専用の連携を作成することをおすすめします。用途がひと目で分かり、必要になったときにその連携だけを無効にできます。