小程序本地商品详情查询接口

开发环境

http://dev-cn.your-api-server.com

GET

https://openapi.alipay.com/v3/alipay/open/app/localitem/query

查询小程序本地商品详情

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://openapi.alipay.com/v3/alipay/open/app/localitem/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "out_item_id": "string",
    "item_id": "string",
    "need_edit_spu": "string"
}'

响应示例

{
    "category_id": "string",
    "item_type": "string",
    "out_item_id": "string",
    "item_id": "string",
    "is_online": true,
    "title": "string",
    "merchant_name": "string",
    "head_img": "string",
    "image_list": [
        "string"
    ],
    "path": "string",
    "item_details_page_model": "string",
    "stock_num": "string",
    "spu_status": "string",
    "sold_time": {
        "start_time": "string",
        "end_time": "string"
    },
    "customer_service_mobile": {
        "phone_type": "string",
        "phone_number": "string",
        "customer_link": "string"
    },
    "create_time": "string",
    "update_time": "string",
    "attrs": [
        {
            "attr_key": "string",
            "attr_value": "string"
        }
    ],
    "risk_info": [
        {
            "audit_time": "string",
            "risk_infos": {
                "risk_name": "string",
                "remark": "string",
                "problem_pic": [
                    "string"
                ]
            }
        }
    ],
    "skus": [
        {
            "sku_id": "string",
            "sale_price": 0,
            "original_price": 0,
            "sale_status": "string",
            "stock_num": 0
        }
    ],
    "scene_risk_info": [
        {
            "scene": "string",
            "scene_code": "string",
            "risk_infos": [
                {
                    "risk_name": "string",
                    "remark": "string",
                    "problem_pic": [
                        "string"
                    ]
                }
            ]
        }
    ]
}

请求参数

Body 参数application/json

out_item_id

string

必需

【描述】商家侧商品id。与支付平台侧商品id不能同时为空，如果都提供，优先使用商家侧商品id。【示例值】12345

item_id

string

必需

【描述】支付平台侧商品id。与商家侧商品id不能同时为空，如果都提供，优先使用商家侧商品id 【示例值】12345

need_edit_spu

string

可选

【描述】是否查询编辑版本，0查询在线版本，1查询编辑版本。默认为0 【示例值】0

示例

返回响应

🟢200成功

application/json

Body

category_id

string

必需

【描述】类目ID 【注意事项】平台类目，填写的类目必须在类目表列出，多级类目只填最后一级。商品类目 ID 及信息可通过商品类目表获取。【示例值】111111

item_type

string

必需

out_item_id

string

必需

【描述】商家侧商品ID，要求 APPID 下全局唯一。【示例值】123456

item_id

string

必需

【描述】支付宝平台侧商品ID，是支付宝平台侧商品的唯一标识，后续与平台交互，需要使用该 ID，建议持久化。【示例值】1000

is_online

boolean

必需

【描述】商品是否在线版本，true在线，false最新版本【示例值】false

title

string

必需

【描述】商品名称，字符类型，最少不低于3，最长不超过60个字。注：1.商品标题只允许汉字、数字、英文字母、特殊字符集；2.商品标题不得仅为数字、字母、特殊字符集或上述三种的组合。【示例值】代金券

merchant_name

string

必需

【描述】商家名称【示例值】merchant_name

head_img

string

必需

【描述】商品主图，图片文件id，图片宽高为750px*750px，宽高比1:1。文件id通过alipay.open.file.upload上传资源获取。【示例值】https://mdn.alipayobjects.com/openpt_appstore/afts/img/A*pHfaSaEsF_0AAAAAAAAAAAAAATcnAQ/original

image_list

array[string]

必需

【描述】商品子图文件id列表，不超过 3 个图片，图片宽高为750px750px，宽高比1:1。文件id通过alipay.open.file.upload上传资源获取。【示例值】["https://mdn.alipayobjects.com/openpt_appstore/afts/img/ApHfaSaEsF_0AAAAAAAAAAAAAATcnAQ/original"]

path

string

必需

【描述】商品详情页链接【示例值】alipays://platformapi/startApp?appId=88888&page=test2

item_details_page_model

string

必需

【描述】1=官方插件版，商品详情页链接不传入 0=自定义详情页版，商品详情页链接必须传入【枚举值】官方插件版: 1 自定义详情页版: 0 【示例值】1

stock_num

string

可选

【描述】库存【示例值】9999

spu_status

string

必需

【描述】审核驳回：商品审核失败时，商品状态为审核驳回。审核中：商品处于审核流程中时，商品状态为审核中。已下架：商家可以通过调用接口下架商品，也可以通过商家后台下架商品。可售卖：商家可以通过调用接口上架商品，也可以通过商家后台上架商品。冻结：当商家出现违规操作时，支付宝侧将发起冻结，商品无法对外透出。当商品包含多个规格时，只要有一个规格的商品状态为“可售卖”，商品状态则为“可售卖”。【枚举值】审核驳回: AUDIT_REJECT 审核中: AUDITING 已下架: DELISTING 更多【示例值】AVAILABLE

sold_time

object

必需

【描述】start_time描述售卖开始时间，end_time描述售卖结束时间，时间格式均为yyyy-MM-dd HH:mm:ss

start_time

string

必需

end_time

string

必需

customer_service_mobile

object

必需

【描述】客服电话，包含区号+电话号码的座机号码格式，以及手机号码格式

phone_type

string

必需

phone_number

string

必需

customer_link

string

必需

create_time

string

必需

【描述】商品创建时间【示例值】2023-01-01 00:00:00

update_time

string

必需

【描述】商品最新更新时间【示例值】2023-01-01 00:00:00

attrs

array [object {2}]

【描述】商品属性

可选

attr_key

string

可选

attr_value

string

可选

risk_info

array [object {2}]

必需

【描述】商品有冻结、驳回时，展示对应的具体问题

audit_time

string

可选

risk_infos

object

可选

skus

array [object {5}]

必需

【描述】sku数组

sku_id

string

可选

sale_price

integer

可选

original_price

integer

可选

sale_status

string

可选

stock_num

integer

可选

scene_risk_info

array [object {3}]

必需

【描述】商品在对应场景屏蔽，展示对应的具体问题

scene

string

可选

scene_code

string

可选

risk_infos

array [object {3}]

可选

修改于 2023-11-21 09:23:17

小程序本地商品修改接口

小程序本地商品分页查询接口