事件详情

您可以通过 Aptoide Connect 开发者控制台或以编程方式通过此 API 端点检索有关特定事件的详细信息。

端点

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

身份验证

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

标头

标头	类型	是否必需	说明
Api-Key	string	必需	用于对您的 API 请求进行身份验证。该值是您的 Aptoide Connect API 密钥。

路径参数

参数	类型	说明
uid	string	事件的唯一标识符（UUID）（例如 56fd535b-b071-402c-a4fa-29807eb050c9）。

请求示例

curl -X GET "https://ws.catappult.io/api/events/56fd535b-b071-402c-a4fa-29807eb050c9" \
  -H "Api-Key: <YOUR_API_KEY>"

响应

成功

如果 API 调用返回 HTTP 200 状态码，则表示请求成功，并返回一个包含有关该事件详细信息的 JSON 对象。

响应示例

{
  "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）的所有推广活动。