メインコンテンツまでスキップ

イベント一覧

アカウントに関連付けられたイベントの一覧は、Aptoide Connect デベロッパーコンソールを通じて、またはこの API エンドポイントを使用してプログラムから取得できます。

エンドポイント​

メソッドURL
GEThttps://ws.catappult.io/api/events

認証​

この API にアクセスするには、Aptoide Connect でアクティブなアカウントサブスクリプションを保有し、API キーで認証する必要があります（生成方法はこちらを確認してください）。

ヘッダー​

ヘッダー型必須説明
Api-Keystring必須API リクエストの認証に使用されます。値は Aptoide Connect の API キーです。

クエリパラメータ​

パラメータ

型

必須

説明

type

string

任意

イベントをタイプ（例: CUSTOM）でフィルタリングします。すべての値のセットについては、利用可能なイベントタイプの一覧を参照してください。

applicationName

string

任意

アプリケーションの一意のパッケージ名（例: com.example.test）でイベントをフィルタリングします。

partnerName

string

任意

allowedPartners に指定したパートナー識別子（例: APTOIDE-GAMES）を含むイベントをフィルタリングします。すべての値のセットについては、利用可能なパートナーの一覧を参照してください。

startsAfter

string (date)

任意

startTimestamp が指定した日付より後であるイベントのみを返します。形式: YYYY-MM-DD。

startsBefore

string (date)

任意

startTimestamp が指定した日付より前であるイベントのみを返します。形式: YYYY-MM-DD。

endsAfter

string (date)

任意

endTimestamp が指定した日付より後であるイベントのみを返します。形式: YYYY-MM-DD。

endsBefore

string (date)

任意

endTimestamp が指定した日付より前であるイベントのみを返します。形式: YYYY-MM-DD。

リクエスト例​

curl -X GET "https://ws.catappult.io/api/events" \
  -H "Api-Key: <YOUR_API_KEY>"

レスポンス​

成功​

API 呼び出しが HTTP 200 ステータスコードを返した場合、リクエストは成功であり、認証されたアカウントに関連付けられたイベントオブジェクトの配列が返されます。

レスポンス例​

[
  {
    "uid": "56fd535b-b071-402c-a4fa-29807eb050c9",
    "name": "Test Event",
    "type": "CUSTOM",
    "status": "active",
    "startTimestamp": "2026-02-04 00:30:00",
    "endTimestamp": "2026-04-30 00:00:00",
    "createdAt": "2026-02-05 16:06:33",
    "updatedAt": "2026-04-01 14:30:34",
    "allowedPartners": ["APTOIDE-GAMES"],
    "application": {
      "name": "com.aptoide.diceroll.sdk",
      "title": "Aptoide Diceroll SDK",
      "iconUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/icon",
      "featureGraphicUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/featureGraphic"
    },
    "data": {
      "allowedPartners": "APTOIDE-GAMES",
      "applySameFilesToAllLocales": "false"
    },
    "locales": [
      {
        "localeName": "en_GB",
        "description": "Test",
        "longDescription": "Test",
        "files": [
          {
            "id": 863,
            "name": "b737866e7065a09e02a8393dd4c83a42_com-aptoide-diceroll-sdk-none-promotion-asset.webp",
            "downloadUrl": "https://cdn-catappult.aptoide.com/promotion_asset/b737866e7065a09e02a8393dd4c83a42_com-aptoide-diceroll-sdk-none-promotion-asset.webp",
            "ratio": "256:125"
          }
        ]
      }
    ],
    "promotions": [
      {
        "uid": "9dbf70ff-30a4-4d82-b062-42ab24126e59",
        "name": "Test Promotion 1",
        "type": "SEARCH",
        "status": "active",
        "startTimestamp": "2026-03-16 00:00:00",
        "endTimestamp": "2026-04-30 00:00:00",
        "createdAt": "2026-03-26 20:47:20",
        "updatedAt": "2026-04-20 15:56:27",
        "hasStatistics": false,
        "event": null,
        "partner": { "name": "APTOIDE-GAMES" },
        "application": {
          "name": "com.aptoide.diceroll.sdk",
          "title": "Aptoide Diceroll SDK",
          "operatingSystem": "android",
          "iconUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/icon",
          "featureGraphicUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/featureGraphic"
        },
        "data": {
          "name": "Test Promotion 1",
          "oemId": "562c8031d4a08ba95e682a800cd04448",
          "utmContent": "search"
        },
        "files": [
          {
            "id": 385,
            "name": "64c5826a724c1bb78332c0ed67b5f83b_com-aptoide-diceroll-sdk-none-promotion-asset.png",
            "downloadUrl": "https://cdn-catappult.aptoide.com/promotion_asset/64c5826a724c1bb78332c0ed67b5f83b_com-aptoide-diceroll-sdk-none-promotion-asset.png"
          }
        ]
      }
    ]
  }
]

promotions 配列には、イベントに（プロモーションの eventUid を介して）リンクされたすべてのプロモーションが含まれます。