メインコンテンツへスキップ
このガイドは単一企業のセットアップを対象としています。複数ユーザーを扱う Business プランおよび Enterprise プランのご購読には、カスタマイズされた統合ガイドをご用意しています。

ソーシャルメディアアカウントを連携する

Ayrshare アカウント にログインまたはサインアップしてください。 Social Account ページで、連携したいソーシャルネットワークをクリックします。 すべての権限を必ず付与してください。

Facebook Linking Example

API Key を取得する

API エンドポイントへのアクセスを認可するには API Key が必要です。 この Key はリクエストのヘッダーで使用し、Bearer キーワードを前に付ける必要があります。 API Key は Ayrshare DashboardAPI Key ページにあります。必要に応じて User Profiles ページで ‘Primary Profile’ に切り替えてください。 その後、左側パネルにある API Key ページを開けます。 API Key すべての API 呼び出しでは、ヘッダーに Bearer トークンを使って API Key を含める必要があります。また、Content-Type として application/json も含めてください。
Header
詳細は Authorization を参照してください。

最初の API 投稿を送信する

投稿の公開

以下は、当社の API を使ってさまざまなプログラミング言語で投稿する方法を示すコード例です。 さらに簡単に統合するには、事前構築された SDK パッケージ のいずれかを使用できます。 投稿を行うには以下が必要です:
  • 認証用の API Key
  • 投稿のテキスト内容。
  • 投稿先のソーシャルメディアプラットフォーム(連携済みのプラットフォームのみを含めてください)。
  • 任意: 含めたい画像や動画の URL。
すべての例で /post エンドポイントを使用します。サンプルコードを見てみましょう:
X/Twitter に投稿する場合は? X には独自の API 認証情報が必要です。リクエストに 2 つの BYO ヘッダー(X-Twitter-OAuth1-Api-KeyX-Twitter-OAuth1-Api-Secret)を追加してください。これは Ayrshare アカウントごとに 1 回限りのセットアップ であり、同じキーペアがすべてのサブプロファイル/エンドユーザーで機能します。詳細は セットアップガイド を参照してください。
おめでとうございます!最初の投稿を送信できました。

投稿レスポンス

当社の API が投稿を正常に処理すると、status が “success” のレスポンスを受け取ります。レスポンスには以下が含まれます:
  • status: API 呼び出し全体のステータス(“success” または “error”)
  • errors: 発生したエラーの配列(成功した場合は空)
  • postIds: プラットフォーム固有の詳細を含むオブジェクトの配列:
    • プラットフォーム名
    • そのプラットフォームでの投稿 ID
    • 投稿を閲覧するための URL
    • その他のプラットフォーム固有の情報
postIds 配列内の各プラットフォームは独自のステータスを持つため、どのプラットフォームが投稿を正常に受信したかを確認できます。 投稿が正常に処理され、公開されているかを確認するには、ソーシャルメディアページをチェックしてください。プラットフォームによっては、投稿が公開表示されるまで若干の遅延が生じる場合があります。 サンプルレスポンスは以下のとおりです:
Post Response
Node.js、Python、PHP、Golang、C#、Ruby でソーシャルメディア API を呼び出すその他のコード例や、その他の優れた機能を確認してください:

Post

もう少し詳しく見る

今回 API 呼び出しをしたときに実際に何が起きたのか、プロセスを分解して見てみましょう。
1

ヘッダーを設定

Header の Authorization bearer トークン(API Key)と content type を json に設定しました。
2

Body オブジェクトを作成

次に、body オブジェクトを作成しました:
  • “Today is a great day!” というテキストを含む投稿。
  • Facebook、Instagram、LinkedIn というソーシャルネットワークプラットフォーム。 Social Linkage ページで連携したプラットフォームのみを含めるようにしてください。
  • mediaUrls に画像を追加。
3

/post エンドポイントを呼び出す

すべてを /post エンドポイントに HTTP POST として送信しました。

出発前に、いくつかのベストプラクティス

ドキュメントを読む

当社では広範かつ最新のドキュメントを維持しています。すでにここにいらっしゃるので、少し時間を取って左のナビゲーションのドキュメントセクションを確認してみてください。

エラーコードは重要

ユーザーが優れた体験を得られるよう、これらを適切に処理する必要があります。

Errors

API Key を安全に保つ

当社はセキュリティを非常に重視しており、皆さまもそうすべきです。Ayrshare とソーシャルメディアアカウントとの接続はあなたが完全に制御します。アカウントが接続されたら、Ayrshare の API Key が認証手段となります。この Key は秘密にし、安全に保管してください。

テスト投稿を公開する

/post エンドポイントrandomPostrandomMediaUrlisLandscapeVideo または isPortraitVideo パラメーターを使って、ランダムな引用、画像、または動画で投稿をテスト公開できます。randomPost を使用する場合、post パラメーターは不要です。
これらの投稿はソーシャルメディアページ上でライブ状態になるため、必要に応じてテスト後に削除してください。

ランダムな引用

randomPost: true を追加することで、投稿公開のテスト用にランダムな引用を送信します。 /post エンドポイントで使用します。

ランダムな画像

randomMediaUrl: true を追加することで、ランダムな画像を送信します。 /post エンドポイントで使用します。

ランダムな動画

isVideo: trueisLandscapeVideo: true を追加することで、ランダムな横向き動画を送信します。 動画は標準的な横向きサイズになります。 /post エンドポイントで使用します。
TikTok や Facebook/Instagram Reels に必要な、ランダムな縦向き動画は isVideo: trueisPortraitVideo: true を追加することで送信できます。 /post エンドポイントで使用します。

ランダムなコメント

randomComment: true を追加することで、コメント公開のテスト用にランダムなコメントを送信します。 /comment エンドポイントで使用します。

cURL 呼び出しの例

ランダムな引用と縦向き動画を送信します。

Postman を使って API 呼び出しをテストする

Postman は API 呼び出しをテストするための素晴らしいツールです。十数言語のコードを生成することもできます。

デモコード

React と NodeJS のサンプルデモプロジェクトをお探しの場合は、以下の GitHub リポジトリをご覧ください:

Github Social Posting Demo App

よくあるトラブルシューティング

うまくいかないこともあるので、当社のヘルプセンターに少しヘルプがあります。

Troubleshooting

お困りの際はお問い合わせください

サポートいたしますので、右下のチャットまたは メール でお気軽にお問い合わせください。