BlogDrip APIで自社のリンクビルディング自動化ツールを構築

カスタムダッシュボード、SEO代理店プラットフォーム、社内CRMなど自分たちのソフトウェアをBlogDripのゲスト投稿注文ワークフローに接続したい広告主アカウント向けです。典型的な利用者は大量のキャンペーンを管理する代理店、既存のスタックに統合する社内のSEOチーム、特定のクライアントやプロダクト向けに運用ツールを作る開発者です。

統合自体を構築するには必要です。APIはプログラム的インターフェースであり、利用にはコードを書くか開発者と協力する必要があります。統合作業なしで運用上の利点だけ欲しい場合は、マーケットプレイスのUIで同じ注文機能を手動で使えます。

合計で少なくとも月額 €500 を支出するアクティブなBlogDripアカウントが必要です — 手動注文とAPI注文の両方が閾値にカウントされます。ある月に支出が下回るとAPIアクセスは自動的に無効化されます。€500はボリュームの閾値であり、別途のAPIサブスクリプション料ではありません。

公式のAPIドキュメントは app.blogdrip.com/api/public/docs/index.html に公開されており、機械可読のOpenAPI仕様は app.blogdrip.com/api/public/openapi.json にあります。両方とも認証方式、`/api/public/*`ネームスペース下の全エンドポイント一覧、リクエスト／レスポンスの形、ページネーション形式、エラー応答を説明しています。統合のソースオブトゥルースとして扱ってください。

app.blogdrip.com/settings のマイ設定 → APIアクセスで確認できます。`x-client-id` と `x-client-secret` が発行され、それぞれ認証付きリクエストのHTTPヘッダに入れます。シークレットは発行またはローテート時に一度だけ表示されるため、後で取得できません — すぐにシークレットマネージャーにコピーしてください。認証情報はアカウント単位です。通常のシークレットと同様に扱い、バージョン管理に入れないでください。

一覧エンドポイントはレスポンスを`{ data, pagination }`でラップし、0ベースのページングを使用します — 最初のページは`?page=0`、2ページ目は`?page=1`と渡します。レスポンス内のpaginationブロックが追加ページの有無を示します。従来の`/api/<path>`インターフェースから移行する場合、レスポンス形状は変わらず、ベースパスが`/api/public/*`に移動するだけです。

サポートされているコールバックやイベント通知の一覧は app.blogdrip.com/api/public/openapi.json のOpenAPI仕様を確認してください。機能がリストにない場合は存在することを仮定せず、代替として独自スケジュールでAPIをポーリングする設計を検討してください。

その権威ある回答は現在のAPIドキュメントにあります。サンドボックスが記載されていれば統合テストに使用してください。記載がない場合は、明示的な許可なしに自動テストで実際の有料注文を作成しないでください — 専用のテストキャンペーンと人のレビューを使ってテストしてください。

Instant Publishingの可用性は、選択したサイトが対応する自動公開統合（BlogDripのWordPressプラグインかAgency API接続のいずれか）を持っているかに依存します。対象サイトであればAPI注文でも手動注文でも自動公開の恩恵を受けられます。マーケットプレイス内のすべてのサイトが対応しているわけではないため、公開タイミングはサイトごとに異なるものとして統合を設計してください。

Advertiser APIは自社のソフトウェアからゲスト投稿注文を自動化したい顧客向けです。Agency APIは外部の代理店、リンクビルディングプラットフォーム、パブリッシャーネットワークが自分たちのインベントリをBlogDripに接続し、対応するフルフィルメントを自動化したい場合のためのものです。両者は独立しており、片方を使うことが他方の使用を必須にするわけではありません。

確認済みのレスポンスを受け取っていない場合、最初のリクエストがサーバー側で成功している可能性を想定してください。非冪等な注文作成を自動で再試行しないでください。サーバー側の重複排除キーを追加するか、再試行前に可能性のある注文を問い合わせるなど、ワークフローがクリーンにサポートする方法を使ってください。成功しているがレスポンスを見逃した注文を再試行すると二重請求が発生します。