应用内订阅列表

🚧

开发中的功能

应用内订阅目前正在开发中，即将发布。 此端点在发布前可能会发生变化。

您可以通过 Aptoide Connect 开发者控制台或以编程方式使用此 API 端点，检索与您应用程序关联的应用内订阅列表。

端点

方法	URL
GET	https://ws.catappult.io/api/applications/{applicationName}/subscriptions

认证

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

⚠️

所需的账户类型

应用内订阅只能由 Developer 类型的账户检索。

标头

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

路径参数

参数	类型	说明
applicationName	string	应用程序的唯一软件包名称（例如 com.example.test）。

查询参数

参数	类型	是否必需	说明
operatingSystem	string (URL)或 file	可选（默认值：android）	要为其检索应用内订阅的操作系统。 可能的值： • android • ios
limit	number	可选（默认值：50）	响应中返回的记录的最大数量。
cursor	string	可选	用于分页的游标，指示从上一次响应的何处继续获取数据。

响应

成功

如果 API 调用返回 HTTP 200 状态码，则表示请求成功，并返回与指定应用程序关联的应用内订阅对象数组。

{
    "data": [
        {
            "addedTimestamp": "2025-01-01 00:00:00",
            "freeTrialPeriod": null,
            "gracePeriod": null,
            "id": "BT3XD2PNZ54OHDC7",
            "locale": {
                "description": "Descripcion",
                "locale": "es",
                "title": "Titulo"
            },
            "modifiedTimestamp": "2025-01-01 00:00:00",
            "period": "P1W",
            "referencePrice": {
                "amount": 1,
                "currency": "USD"
            },
            "sku": "subscription01",
            "status": "ACTIVE"
        }
    ],
    "nextCursor": null
}