活动列表

您可以通过 Aptoide Connect 开发者控制台，或使用此 API 端点以编程方式检索与您账户关联的活动列表。

端点

方法	URL
GET	https://ws.catappult.io/api/events

身份验证

要访问此 API，您需要在 Aptoide Connect 上拥有有效的账户订阅，并使用 API 密钥进行身份验证（请查看此处了解如何生成密钥）。

请求头

请求头	类型	是否必需	描述
Api-Key	string	必需	用于验证您的 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）链接到该活动的所有促销活动。