服务商推广关系查询接口 -凯发app官方网站

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.servicemarket.promotiontask.relation.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

commodity_id必选string(200)

【描述】服务商品id，并不是uid，取值来源于前端的获取

【示例值】ss010101000000003954

page_size｜分页的大小可选number(32)

【描述】每页数量，范围(1-100)。默认：10

【示例值】10

page_num可选number(5)

【描述】当前页码，从1开始。默认：1

【示例值】1

参数	类型	是否必选	最大长度	描述	示例值
commodity_id	string	必选	200	服务商品id，并不是uid，取值来源于前端的获取	ss010101000000003954
page_size	number	可选	32	每页数量，范围(1-100)。默认：10	10
page_num	number	可选	5	当前页码，从1开始。默认：1	1

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.servicemarket.promotiontask.relation.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'app_auth_token=${app_auth_token}' \
 -f 'biz_content={
	"commodity_id":"ss010101000000003954",
	"page_size":10,
	"page_num":1
}'

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

page_size｜分页大小必选number(5)

【描述】每页数量

【示例值】10

total_size｜总个数必选number(7)

【描述】总记录数

【示例值】1000

current_page必选number(5)

【描述】当前页码

【示例值】1

promotion_relations可选promotiontaskrelation[]

【描述】推广服务商信息列表

promotion_id必选string(20)

【描述】推广任务id

【示例值】2018052401048283

promotion_name必选string(100)

【描述】推广任务的名称

【示例值】测试推广任务

commodity_id必选string(30)

【描述】服务商品id

【示例值】ss010101000000003954

commodity_name必选string(100)

【描述】服务商品名称

【示例值】测试服务

promoter_pid必选string(32)

【描述】推广服务商的pid

【示例值】20883013xxxxxxxx

promoter_name必选string(200)

【描述】推广服务商的名称

【示例值】xx商户

promoter_contact_name必选string(50)

【描述】推广服务商联系人名称

【示例值】张三

promoter_contact_phone必选string(20)

【描述】推广服务商联系电话

【示例值】136xxxxxxxx

create_time必选string(20)

【描述】推广关系创建时间

【示例值】2020-10-12 12:10:10

apply_reason可选string(2048)

【描述】申请推广时填写的申请理由，自定义的内容

【示例值】xxx

参数	类型	是否必选	最大长度	描述	示例值
page_size	number	必选	5	每页数量	10
total_size	number	必选	7	总记录数	1000
current_page	number	必选	5	当前页码	1
promotion_relations	promotiontaskrelation[]	可选		推广服务商信息列表

响应示例

正常示例

异常示例

{
    "alipay_open_servicemarket_promotiontask_relation_query_response": {
        "code": "10000",
        "msg": "success",
        "page_size": 10,
        "total_size": 1000,
        "current_page": 1,
        "promotion_relations": [
            {
                "promotion_id": "2018052401048283",
                "promotion_name": "测试推广任务",
                "commodity_id": "ss010101000000003954",
                "commodity_name": "测试服务",
                "promoter_pid": "20883013xxxxxxxx",
                "promoter_name": "xx商户",
                "promoter_contact_name": "张三",
                "promoter_contact_phone": "136xxxxxxxx",
                "apply_reason": "xxx",
                "create_time": "2020-10-12 12:10:10"
            }
        ]
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

公共错误码

业务错误码

错误码	错误描述	凯发app官方网站的解决方案
params_error	入参参数校验失败，该字段不能为空	对照文档检查入参的必填属性、格式、长度限制
query_faild	内部查询超时，尝试重新发起调用	由于网络原因导致的查询失败，请尝试重新调用

公共请求参数

业务请求参数

公共响应参数

业务响应参数

公共错误码

业务错误码

相关问题