添加应用内商品

如下所述，您可以通过开发者控制台或我们的 API 在 Aptoide Connect 上向您的应用程序添加应用内商品。

端点

方法	URL
POST	https://ws.catappult.io/api/applications/{applicationName}/consumables

身份验证

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

⚠️

所需帐户类型

只有 Developer 类型的帐户才能创建应用内商品。

请求头

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

路径参数

参数	类型	说明
applicationName	string	标识将为其创建应用内商品的应用程序。（例如 com.example.test）。

查询参数

参数	类型	是否必需	说明
operatingSystem	string (URL)或 file	可选（默认：android）	指定为给定应用程序添加应用内商品所针对的操作系统。可能的值： • android • ios

请求体参数

⚠️

重要

所有参数都必须始终作为表单数据 (multipart/form-data) 发送，即使您提供的是 URL 而非上传文件。

不支持 JSON 请求。请在 cURL 中使用 -F 标志发送每个字段。

注意：

• 如果未定义国家/地区专属的零售价格，则最终收费将在购买时根据参考价格自动转换。
• 所有 countryPrices 参数 (countryPrices[<country_code>][...]) 均可使用任何受支持的 ISO 3166-1 alpha-2 国家/地区代码。
• 所有 locale 参数 (locales[<language_code>][...]) 均可使用任何 ISO 639 语言代码。您可以一次为多种语言提供 locale 参数，但只能将其中一种设置为默认值。

参数	类型	是否必需	说明
sku	string	必需	应用内商品的唯一标识符（例如 product01）。
referencePriceCurrency	string	必需	参考价格的 ISO 4217 货币代码。请参阅可用货币代码。
referencePriceAmount	string	必需	参考价格的数值。
countryPrices[<country_code>]	string	可选	指定国家/地区的价格。
locales[<language_code>][title]	string	可选	指定语言的标题。
locales[<language_code>][description]	string	可选	指定语言的说明。
locales[<language_code>][isDefault]	boolean	可选	将此语言设置为默认值。

响应

成功

如果 API 调用返回 HTTP 200 状态代码，则请求成功，并且应用内商品已添加到您的应用程序中。

示例

应用 com.example.app 中应用内商品 product01 的示例，参考价格为 1 USD，葡萄牙 (PT) 的国家/地区专属价格设置为 2 EUR，并包含西班牙语 (es) 和葡萄牙语 (pt) 的本地化内容 (cURL)：

curl -X POST "https://ws.catappult.io/api/applications/com.example.app/consumables?operatingSystem=android" \
  -H "Api-Key: YOUR_API_KEY" \
  -F "sku=product01" \
  -F "referencePriceCurrency=USD" \
  -F "referencePriceAmount=1" \
  -F "countryPrices[PT]=2" \
  -F "locales[es][title]=Titulo" \
  -F "locales[es][description]=Descripcion" \
  -F "locales[es][isDefault]=true" \
  -F "locales[pt][title]=Titulo" \
  -F "locales[pt][description]=Descricao" \
  -F "locales[pt][isDefault]=false"