获取产品列表（Apple）

• 接口说明
• 请求路径
• 请求参数
• 请求示例代码
• 返回响应
• 产品类型说明
• 错误码说明

接口说明

获取苹果应用内购买(IAP)商品列表，支持按销售状态、商品类型和Apple产品类型筛选。

注意事项

1. 商品按照排序值（order）升序排列
2. 默认返回最多100条记录
3. 默认返回上架状态的商品
4. 支持会员时长、永久会员等多种商品类型
5. 价格单位为分
6. 支持Apple产品类型筛选：消耗型、非消耗型、自动续期订阅、非续期订阅
7. function_value字段说明：
   • 当type=1(时长会员)时，表示会员时长天数
   • 当type=2(永久会员)时，固定值为"forever_vip"

使用场景

• 消费型商品：游戏币、道具、VIP时长等可重复购买的商品
• 非消费型商品：去广告、解锁功能等一次性购买的商品
• 自动续期订阅：月度会员、年度会员等自动续费的订阅服务
• 非续期订阅：季度通行证等固定期限的订阅服务

请求路径

请求参数

公共参数

业务参数

请求示例代码

获取所有上架商品

curl --location --request GET 'https://api.zaihangyun.com/v1/product/iap/list' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'User-Agent: Apifox/1.0.0' \
--data '{
    "appkey": "D5fceA1sVtmaMY1F",
    "timestamp": 1650381362,
    "sign": "5HC0kxCm2jsR3DpzhRJEFY3IfFvTcCN-8-qvvLCrKB8",
    "status": 1
}'

获取自动续期订阅商品

curl --location --request GET 'https://api.zaihangyun.com/v1/product/iap/list' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'User-Agent: Apifox/1.0.0' \
--data '{
    "appkey": "D5fceA1sVtmaMY1F",
    "timestamp": 1650381362,
    "sign": "5HC0kxCm2jsR3DpzhRJEFY3IfFvTcCN-8-qvvLCrKB8",
    "status": 1,
    "apple_product_type": 3
}'

获取永久会员商品

curl --location --request GET 'https://api.zaihangyun.com/v1/product/iap/list' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'User-Agent: Apifox/1.0.0' \
--data '{
    "appkey": "D5fceA1sVtmaMY1F",
    "timestamp": 1650381362,
    "sign": "5HC0kxCm2jsR3DpzhRJEFY3IfFvTcCN-8-qvvLCrKB8",
    "status": 1,
    "type": 2
}'

返回响应

成功返回（查看字段解析）

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "pid": 55513647,
            "iap_product_id": "timestamp.kongmuhu.com.forver_vip",
            "name": "永久会员",
            "sub_name": "永久",
            "apple_product_type": 2,
            "subscription_duration": null,
            "type": 2,
            "function_value": "forever_vip",
            "cross_price": 199900,
            "sale_price": 9900,
            "desc": "苹果的商店就是麻烦",
            "sale_status": 1,
            "ext_data": "{}"
        },
        {
            "pid": 55513648,
            "iap_product_id": "timestamp.kongmuhu.com.monthly_vip",
            "name": "月度会员",
            "sub_name": "1个月",
            "apple_product_type": 3,
            "subscription_duration": 2,
            "type": 1,
            "function_value": "30",
            "cross_price": 3900,
            "sale_price": 1900,
            "desc": "自动续费月度会员",
            "sale_status": 1,
            "ext_data": "{}"
        }
    ]
}

返回字段说明

错误返回

{
    "code": 400105,
    "msg": "apple_product_type must be integer"
}

产品类型说明

Apple产品类型 (apple_product_type)

功能模型 (type)

订阅时长类型 (subscription_duration)

产品类型组合建议

错误码说明

查看全局错误码

参数验证错误

错误处理建议

1. 参数类型错误（400101, 400103, 400105）：

   • 检查参数数据类型是否正确
   • 确保传递的是整数而非字符串

2. 参数值范围错误（400102, 400104, 400106）：

   • 检查参数值是否在允许的范围内
   • 参考产品类型说明表确认正确的参数值

3. 最佳实践：

   • 优先使用 apple_product_type 筛选，更符合Apple IAP的分类逻辑
   • 结合 type 和 apple_product_type 可以实现精确筛选
   • 建议按业务场景选择合适的筛选条件