1.jingdong.homefw.task.identify(核销)接口
API描述
对于需要核销码来核实用户满意的,通过向用户索取核销码并通过调用此接口回传到京东;
请求类:HomefwTaskIdentifyRequest
名称 | 类型 | 是否必填 | 示例值 | 描述 |
appid | String | 是 |
| 宙斯平台应用appid |
venderCode | String | 否 |
| 识别码,可为空 |
orderNo | String | 是 |
| 任务工单号 |
indentifyCode | String | 否 |
| 核销码 |
结果集
名称 | 类型 | 是否必须 | 示例值 | 描述 |
returnType | ResultInfo | 是 |
| 返回结果集,详见下面说明 |
ResultInfo
名称 | 类型 | 是否必须 | 示例值 | 描述 |
resultCode | Number | 是 | 100 | 返回码: 100:返回成功;200:返回失败 |
errMsg | String | 否 | 参数不全 | 失败原因描述 |
返回码解释
返回码 | 解释 | 产生原因 | 解决方式 |
100 | 执行成功 |
|
|
200 | 参数设置错误 | 参数过期或错误 | 检查参数 |
2.Java实现
官方Java实现,地址https://jos.jd.com/api/sdkExampleTemplate.htm?id=4821
public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
HomefwTaskIdentifyRequest request=new HomefwTaskIdentifyRequest();
request.setVenderCode( "jingdong" );
request.setOrderNo( "jingdong" );
request.setIndentifyCode( "jingdong" );
HomefwTaskIdentifyResponse response=client.execute(request);
自己写的Java实现
public class JDAPIParent {
public static String serverUrl = "https://api-dev.jd.com/routerjson";
public static String accessToken = "***";
public static String appKey = "***";
public static String appSecret = "***";
// 用户签收/核销 jingdong.homefw.task.identify
public static HomefwTaskIdentifyResponse homefwTaskIdentify(
HomefwTaskIdentifyRequest request) throws Exception {
JdClient client=new DefaultJdClient(serverUrl,accessToken,appKey,appSecret);
return client.execute(request);
}
}
// 用户签收/核销 jingdong.homefw.task.identify
public JdResultVO homefwTaskIdentify(String orderNo,String indentifyCode) {
HomefwTaskIdentifyRequest request=new HomefwTaskIdentifyRequest();
try {
request.setVenderCode(VENDER_CODE);
request.setOrderNo(orderNo);
request.setIndentifyCode(indentifyCode);
HomefwTaskIdentifyResponse response=JDAPIParent.homefwTaskIdentify(request);
//保存明细
jdApilogService.insert(request.getApiMethod(),
ReflectionToStringBuilder.toString(request),
ReflectionToStringBuilder.toString(response.getResultInfo()));
return new JdResultVO();
}catch (Exception e){
jdApierrorService.insert(new HomefwTaskIdentifyRequest().getApiMethod(),
ReflectionToStringBuilder.toString(request),
StringUtil.getExceptionAllinformation(e));
}
return new JdResultVO("失败");
}