# 获取面单联系人信息

调试工具

接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

getContact

# 功能描述

该接口用于获取面单联系人信息。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/cgi-bin/express/delivery/contact/get?access_token=ACCESS_TOKEN

# 云调用

出入参和HTTPS调用相同，调用方式可查看云调用说明文档
接口方法为: openapi.logistics.getContact

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token
token	string	是	商户侧下单事件中推送的 Token 字段
waybill_id	string	是	运单 ID

# 返回参数

属性

类型

说明

waybill_id

string

运单 ID

sender

object

发件人信息

属性	类型	说明
name	string	用户姓名
tel	string	座机号码
mobile	string	手机号码
address	string	地址，已经将省市区信息合并

receiver

object

收件人信息

属性	类型	说明
name	string	用户姓名
tel	string	座机号码
mobile	string	手机号码
address	string	地址，已经将省市区信息合并

# 调用示例

示例说明: HTTPS调用

# 请求数据示例


{
  "token": "TOKEN",
  "waybill_id": "12345678901234567890"
}

# 返回数据示例


{
  "waybill_id": "12345678901234567890",
  "sender": {
    "address": "广东省广州市海珠区XX路XX号XX大厦XX栋XX",
    "name": "张三",
    "tel": "020-88888888",
    "mobile": "18666666666"
  },
  "receiver": {
    "address": "广东省广州市天河区XX路XX号XX大厦XX栋XX",
    "name": "王小蒙",
    "tel": "029-77777777",
    "mobile": "18610000000"
  }
}

示例说明: 云函数调用

# 请求数据示例


const cloud = require('wx-server-sdk')
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.logistics.getContact({
        "token": 'TOKEN',
        "waybillId": '12345678901234567890'
      })
    return result
  } catch (err) {
    return err
  }
}

# 返回数据示例


{
  "waybillId": "12345678901234567890",
  "sender": {
    "address": "广东省广州市海珠区XX路XX号XX大厦XX栋XX",
    "name": "张三",
    "tel": "020-88888888",
    "mobile": "18666666666"
  },
  "receiver": {
    "address": "广东省广州市天河区XX路XX号XX大厦XX栋XX",
    "name": "王小蒙",
    "tel": "029-77777777",
    "mobile": "18610000000"
  },
  "errMsg": "openapi.logistics.getContact:ok"
}

# 错误码

错误码	错误码取值	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试