寄快递
京东万象 官方文档
寄快递
基本说明:
接口地址: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))
}