如果存在手艺人id,忽略其它参数,根据手艺人id查询; 如果知道手艺人外部id,没有手艺人id,根据手艺人外部id查询; 如果不知道具体的手艺人id,手艺人外部id,那么就传入shopId,把门店下的所有手艺人都查询出来;
| 环境 | HTTPS请求地址 |
|---|---|
| 正式环境 | https://openapi.alipay.com/gateway.do |
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| app_id | String | 是 | 32 | 支付宝分配给开发者的应用ID | 2014072300007148 |
| method | String | 是 | 128 | 接口名称 | koubei.craftsman.data.provider.batchquery |
| format | String | 否 | 40 | 仅支持JSON | JSON |
| charset | String | 是 | 10 | 请求使用的编码格式,如utf-8,gbk,gb2312等 | utf-8 |
| sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 | RSA2 |
| sign | String | 是 | 256 | 商户请求参数的签名串,详见签名 | 详见示例 |
| 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 | 是 | - | 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档 |
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| craftsman_ids | String [] | 可选 | 64 | 手艺人id (如果传入craftsman_ids,会忽略其他参数:注意,不能与shop_id同时为空),以数组方式传值 | 210937 |
| out_craftsman_ids | String [] | 可选 | 64 | 手艺人外部id(如果没有传craftsman_ids,传了craftsman_external_ids,会忽略其他参数,注意,不能与shop_id 同时为空) | 20161227 |
| shop_id | String | 可选 | 64 | 口碑门店id(不能与craftsman_ids和out_craftsman_ids同时为空) | 2015123000077000000002414370 |
| recommend | Boolean | 可选 | 16 | 是否推荐 (true 返回在c端展示的手艺人,false 返回c端隐藏的手艺人,不传表示不过滤) | true |
| page_no | String | 可选 | 4 | 页码,大于0,最大为int的最大值 | 1 |
| page_size | String | 可选 | 4 | 每页的条数,大于0,最大不超过100条 | 20 |
| qr_code_shop_id | String | 可选 | 64 | 手艺人码对应的门店,只有指定了码门店字段,才会返回手艺人码信息 | 2016102100077000000003441154 |
| auth_code | String | 可选 | 64 | 服务商、服务商员工、商户、商户员工等口碑角色操作时必填,对应为 koubei.member.data.oauth.query 中的 auth_code,默认有效期24小时;ISV自身角色操作的时候,无需传该参数 | 6a8713a414da4a2dafdb7c24e597TX80 |
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | 是 | - | 网关返回码,详见文档 | 40004 |
| msg | String | 是 | - | 网关返回码描述,详见文档 | Business Failed |
| sub_code | String | 否 | - | 业务返回码,详见文档 | ACQ.TRADE_HAS_SUCCESS |
| sub_msg | String | 否 | - | 业务返回码描述,详见文档 | 交易已被支付 |
| sign | String | 是 | - | 签名,详见文档 | DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo= |
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| craftsmans | CraftsmanOpenModel [] | 必填 | - | craftsmans:手艺人信息 | |
|
|||||
| page_size | Number | 必填 | 3 | 每页记录数 | 20 |
| current_page_no | Number | 必填 | 9 | 当前页码 | 1 |
| total_page_no | Number | 必填 | 9 | 总页码数目 | 3 |
| total_craftsmans | Number | 必填 | 9 | 门店下共手艺人数目 | 50 |
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
KoubeiCraftsmanDataProviderBatchqueryRequest request = new KoubeiCraftsmanDataProviderBatchqueryRequest();
request.setBizContent("{" +
"\"craftsman_ids\":[" +
"\"210937\"" +
"]," +
"\"out_craftsman_ids\":[" +
"\"20161227\"" +
"]," +
"\"shop_id\":\"2015123000077000000002414370\"," +
"\"recommend\":true," +
"\"page_no\":\"1\"," +
"\"page_size\":\"20\"," +
"\"qr_code_shop_id\":\"2016102100077000000003441154\"," +
"\"auth_code\":\"6a8713a414da4a2dafdb7c24e597TX80\"" +
"}");
KoubeiCraftsmanDataProviderBatchqueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}
{
"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
"koubei_craftsman_data_provider_batchquery_response":{
"msg":"Success",
"code":"10000",
"total_page_no":3,
"current_page_no":1,
"craftsmans":[
{
"out_craftsman_id":"20161227",
"operator_id":"2088201963612200",
"tel_num":"18018801880",
"avatar":"TxFyuus3RUW8wAeYfubM7gAAACMAAQED/http://tfs.alipayobjects.com/images/partner/xxxxxxxxxxxxxxxxx_160X160",
"title":"高级造型师",
"craftsman_id":"210937",
"careers":[
"发型师"
],
"assessment":{
"sub_assessments":[
{
"score":4.0,
"title":"服务态度"
}
],
"total_score":5.0,
"total_no":999
},
"shop_relations":[
{
"shop_id":"2016102100077000000003441154",
"recommend_weight":0
}
],
"career_begin":"2016-12-12",
"user_id":"2088101164264830",
"nick_name":"阿诺,KK.",
"name":"张三",
"qr_code":"https://qr.alipay.com/bavh4wjlxfxxxxxxxx",
"account":"zhangsan",
"specialities":[
"烫发",
"瑜伽",
"有氧"
],
"introduction":"中国好声音御用造型师,2010年获得沙宣美发大赛一等奖,得过沙宣美发学校的证书。",
"status":"EFFECTIVE"
}
],
"page_size":20,
"total_craftsmans":50
}
}
{
"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
"koubei_craftsman_data_provider_batchquery_response":{
"msg":"Service Currently Unavailable",
"code":"20000",
"sub_msg":"系统繁忙",
"sub_code":"isp.unknow-error"
}
}
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| INVALID_PARAMETER | 参数有误 | 请按照错误码描述修改校验不通过的参数 |
| CRAFTSMAN_SHOP_NOT_BELONGS_PID | 手艺人关联门店不属于该商户 | 通过alipay.offline.market.shop.batchquery 或alipay.offline.market.shop.summary.batchquery查询门店对应的pid |
| CRAFTSMAN_NOT_BELONGS_TO_PID | 手艺人不属于该授权商户 | 请使用手艺人归属的商户授权信息访问该接口 |
| SYSTEM_ERROR | 系统繁忙 | 请重试或准备好外部手艺人id、appid等信息给技术支持排查,参考链接https://support.open.alipay.com/alipay/support/index.htm |