基本说明：
| 接口地址：https://way.jd.com/gzchengshu/kdjj |
|---|
| 返回格式：json |
| 请求方式：get/post |
| 请求示例：https://way.jd.com/gzchengshu/kdjj?appkey=key |
请求参数说明：
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| appkey | string | 必填 | 该平台密钥 扫码关注公众号 |
| comCode | string | 必填 | 快递公司编码 |
| recManName | string | 必填 | 收件人姓名 |
| recManMobile | string | 必填 | 收件人的手机号，手机号和电话号二者其一必填 |
| recManPrintAddr | string | 必填 | 收件人所在完整地址，包含省、市、区、街道等 |
| sendManName | string | 必填 | 寄件人姓名 |
| sendManMobile | string | 必填 | 寄件人的手机号，手机号和电话号二者其一必填 |
| sendManPrintAddr | string | 必填 | 寄件人所在的完整地址，包含省、市、区、街道等 |
| cargo | string | 必填 | 物品名称，例：文件（com为jd时，cargo必填） |
| weight | string | 必填 | 物品总重量KG，例：1.5，单位kg |
| remark | string | 必填 | 备注 |
| salt | string | 必填 | 随机字符串 |
| callBackUrl | string | 必填 | 回调地址 |
| payment | string | 必填 | 支付方式，SHIPPER: 寄付（默认），CONSIGNEE: 到付 |
| dayType | string | 必填 | 预约日期，例如：今天/明天/后天 |
| pickupStartTime | string | 必填 | 预约起始时间（HH:mm），例如：09:00 |
| pickupEndTime | string | 必填 | 预约截止时间（HH:mm），例如：10:00 |
返回参数说明：
| 名称 | 类型 | 说明 |
|---|---|---|
| orderId | string | 订单号 |
| taskId | string | 任务号 |
JSON返回示例：
{
"code": "10000",
"charge": false,
"msg": "查询成功",
"result": {
"code": "0",
"message": "成功",
"data": {
"result": "1",
"description": "成功",
"detail": {
"taskId": "5C401C***87D",
"orderId": "102***183"
}
}
}
}
服务级错误码参照
| 错误码 | 说明 |
|---|---|
| 10000 | 查询成功 |
| 10001 | 错误的请求appkey |
| 11010 | 商家接口调用异常，请稍后再试 |
| 11030 | 商家接口返回格式有误 |
| 10003 | 不存在相应的数据信息 |
| 10004 | URL上appkey参数不能为空 |
| 10010 | 接口需要付费，请充值 |
| 10020 | 万象系统繁忙，请稍后再试 |
| 10030 | 调用万象网关失败， 请与万象联系 |
| 10040 | 超过每天限量，请明天继续 |
| 10050 | 用户已被禁用 |
| 10060 | 提供方设置调用权限，请联系提供方 |
| 10070 | 该数据只允许企业用户调用 |
| 10090 | 文件大小超限，请上传小于1M的文件 |
完整教学代码示例
<?php
/**
* Created by PhpStorm.
* User: FZS
* Time: 2021/03/27 15:26
*/
class freeApi
{
private $apiUrl;
public function __construct()
{
$this->apiUrl = 'https://way.jd.com/gzchengshu/kdjj?appkey=key&comCode=shunfeng&recManName=张三&recManMobile=13565548304&recManPrintAddr=xxx省xxx市xxx区xxx街道xxx单元xx室&sendManName=李四&sendManMobile=130xxxxxx&sendManPrintAddr=xxx省xxx市xxx区xxx街道xxx单元xx室&cargo=文件&weight=1&remark=物品&salt=123456&callBackUrl=http:/xxx.com&payment=SHIPPER&dayType=今天&pickupStartTime=09:00&pickupEndTime=14:00';
}
/**
* 获取结果
* @return array
*/
public function getResult()
{
return file_get_contents($this->apiUrl);
}
}package main
import (
"fmt"
"io/ioutil"
"log"
"net/http"
)
const (
APIURL = "https://way.jd.com/gzchengshu/kdjj?appkey=key&comCode=shunfeng&recManName=张三&recManMobile=13565548304&recManPrintAddr=xxx省xxx市xxx区xxx街道xxx单元xx室&sendManName=李四&sendManMobile=130xxxxxx&sendManPrintAddr=xxx省xxx市xxx区xxx街道xxx单元xx室&cargo=文件&weight=1&remark=物品&salt=123456&callBackUrl=http:/xxx.com&payment=SHIPPER&dayType=今天&pickupStartTime=09:00&pickupEndTime=14:00"
)
func main() {
queryUrl := fmt.Sprintf("%s",APIURL)
resp, err := http.Get(queryUrl)
if err != nil {
log.Println(err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}