メインコンテンツへスキップ

​
manage Posts エンドポイントの使い方入門**

このクイックスタート ガイドでは、Postman を使用して manage Posts エンドポイントへ最初のリクエストを送信する手順を説明します。 さまざまな言語のサンプルコードを確認したい場合は、X API v2 sample code の GitHub リポジトリをご覧ください。
前提条件このガイドを完了するには、リクエストを認証するためのキーおよびトークンが必要です。以下の手順に従って、これらのキーおよびトークンを生成できます。
  • デベロッパーアカウントに登録し、承認を受ける。
  • developer portal で Project と、関連付けられた 開発者用 App を作成する。
  • App の「Keys and tokens」ページに移動して、必要な認証情報を生成する。すべての認証情報は必ず安全な場所に保存する。

​
manage Posts リクエストを作成する手順

ステップ1: ツールまたはライブラリを用意する この endpoint にリクエストを送信する方法として利用できるツール、コード例、ライブラリはいくつかありますが、ここでは手順を簡素化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください:
Postman に X API v2 コレクションを読み込んだら、“Manage Posts” フォルダーに移動し、“Create a Post” を選択します。   ステップ2: リクエストを認証する X API に正しくリクエストを送信するには、実行権限があることを確認する必要があります。manage Posts の endpoints を利用するには、OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE のいずれかでリクエストを認証する必要があります。 この例では、OAuth 1.0a User Context を使用します。 Postman にキーおよびトークン（具体的には API Key、API Secret Key、OAuth 1.0a user Access Token、OAuth 1.0a user Access Token Secret）を追加する必要があります。これは、Postman の右上にある “X API v2” という名前の環境を選択し、環境ドロップダウンの横にある目のアイコンをクリックして、“initial value” と “current value” フィールドにキーおよびトークンを追加することで行えます。 正しく設定できていれば、これらの変数はリクエストの Authorization タブに自動的に反映されます。 ステップ3: Post のテキストを指定する この endpoint で新しい Post を作成する際、Post のテキストまたはメディアは必須のボディパラメータです。 Postman で “Body” タブに移動し、text パラメータの値として Post のテキストを入力します。さらに、投票、特定の Post ID への返信、返信設定の追加などのパラメータを追加したい場合は、ここで設定できます。利用可能な項目の詳細は、API リファレンスガイドをご覧ください。
KeyValueParameter type
textHello world!body
ステップ4: 取得したい fields を特定して指定する すべての設定が完了したら、“Send” ボタンをクリックすると、次の例に類似したレスポンスが返ってきます。 
{
  "data": {
    "id": "1445880548472328192",
    "text": "Hello world!"
  }
}
返されたレスポンスオブジェクトに id と対象の Post の text が含まれていれば、Post の作成は成功しています。   ステップ5: Post を削除する Post を削除するには、Postman に読み込まれている X API v2 コレクションの「Manage Posts」フォルダー内にある「Delete a Post」リクエストを選択します。この endpoint では、削除対象の Post の ID が必要です。続いて「Params」タブで、削除したい Post の ID を id 列の値として入力します。  delete リクエストが成功すると、次の例のようなレスポンスが返されます。 
{
   "data": {
       "deleted" : true
   }
}
次の手順 API リファレンス サポート サンプルコード
⌘I