パートナーの取得

このエンドポイントを使用して、パートナーの一覧と関連データを取得します。

事前準備

このエンドポイントを使用するには、Adjust APIトークンが必要です。トークンを取得するには、認証ガイドの手順に従ってください。

エンドポイント

https://api.adjust.com/public/v1/partners

GETリクエスト

このエンドポイントを使用して、パートナーの一覧と関連データを取得します。データはパートナーオブジェクトの配列で返されます。

パラメーター

パラメーターデータタイプin説明
after文字列クエリ次のページから要素を取得するカーソル。
before文字列クエリ前のページから要素を取得するカーソル。
limit整数クエリレスポンスに含まれる要素の最大数。正の整数値であることが必須です。

このエンドポイントからの結果は、カーソルでページネーションされます。各ページには、前ページと次ページの位置が返されます。特定のページを返すには、これらを含めて呼び出してください。また、1 ページに含まれるアイテムの数を制限することも可能です。デフォルトの上限は50になります。

各結果のページには、カーソル位置を含むpagingオブジェクトが含まれます。このカーソル位置を使って、プログラム上でページ間を移動することができます。たとえば、最初のページには、次のような結果が含まれます。

v2
v1
"paging": {
   "next": "https://api.adjust.com/public/v2/apps/gwzpeepw8uf8/trackers/abc123/children?cursor=g2wAAAACYhW1_gxkAANuaWxq",
   "cursor": "g2wAAAACYhW1_gxkAANuaWxq"
}

2ページ目に移動するには、nextリンクをたどって、次に指定されたcursorの位置から結果を返します。

$ curl "https://api.adjust.com/public/v2/apps/gwzpeepw8uf8/trackers/abc123/children?cursor=g2wAAAACYhW1_gxkAANuaWxq"

レスポンス

{
  "id": 174,
  "display_name": "Adcolony",
  "supports_cost_data": true
 }

フィールド

例

cURL
curl --location --request GET 'https://api.adjust.com/public/v1/partners?limit=1' \
--header 'Authorization: Token token={API_TOKEN}'
{
  "data": {
    "api_version": "1",
    "request_id": "FcK55-tdJUDOWQIAABsB",
    "timestamp": "2019-09-09T09:07:06Z",
    "paging": {
      "page_size": "1",
      "collection_size": "1",
      "total": "199",
      "next": "https://api.adjust.com/public/v1/partners?after=g2wAAAACYhW1_gxkAANuaWxq&limit=1",
      "previous": nil,
      "cursors": {
        "after": "g2wAAAACYhW1_gxkAANuaWxq",
        "before": nil
      }
    },
    "items": [
      {
        "id": 174,
        "display_name": "Adcolony",
        "supports_cost_data": true
      }
    ]
  }
}