微信小程序 運(yùn)力方使用·getContact

2022-05-11 15:15 更新

logistics.getContact

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。
本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

獲取面單聯(lián)系人信息

調(diào)用方式:

  • HTTPS 調(diào)用
  • 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

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

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
token string 商戶側(cè)下單事件中推送的 Token 字段
waybill_id string 運(yùn)單 ID

返回值

Object

屬性 類型 說明
waybill_id string 運(yùn)單 ID
sender Array.<Object> 發(fā)件人信息
receiver Array.<Object> 收件人信息
errcode number 錯(cuò)誤碼
errmsg string 錯(cuò)誤信息

sender 的結(jié)構(gòu)

屬性 類型 說明
address string 地址,已經(jīng)將省市區(qū)信息合并
name string 用戶姓名
tel string 座機(jī)號(hào)碼
mobile string 手機(jī)號(hào)碼

receiver 的結(jié)構(gòu)

屬性 類型 說明
address string 地址,已經(jīng)將省市區(qū)信息合并
name string 用戶姓名
tel string 座機(jī)號(hào)碼
mobile string 手機(jī)號(hào)碼

errcode 的合法值

說明 最低版本
0 成功
-1 其他錯(cuò)誤
40199 運(yùn)單 ID 錯(cuò)誤,未查到運(yùn)單
9300507 Token 不正確

請(qǐng)求數(shù)據(jù)示例

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

返回?cái)?shù)據(jù)示例

{
  "waybill_id": "12345678901234567890",
  "sender": {
    "address": "廣東省廣州市海珠區(qū)XX路XX號(hào)XX大廈XX棟XX",
    "name": "張三",
    "tel": "020-88888888",
    "mobile": "18666666666"
  },
  "receiver": {
    "address": "廣東省廣州市天河區(qū)XX路XX號(hào)XX大廈XX棟XX",
    "name": "王小蒙",
    "tel": "029-77777777",
    "mobile": "18610000000"
  }
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力,需要在云函數(shù)中通過 wx-server-sdk 使用。

接口方法

openapi.logistics.getContact
需在 config.json 中配置 logistics.getContact API 的權(quán)限,詳情

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
token string 商戶側(cè)下單事件中推送的 Token 字段
waybillId string 運(yùn)單 ID

返回值

Object

屬性 類型 說明
waybillId string 運(yùn)單 ID
sender Array.<Object> 發(fā)件人信息
receiver Array.<Object> 收件人信息
errCode number 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

sender 的結(jié)構(gòu)

屬性 類型 說明
address string 地址,已經(jīng)將省市區(qū)信息合并
name string 用戶姓名
tel string 座機(jī)號(hào)碼
mobile string 手機(jī)號(hào)碼

receiver 的結(jié)構(gòu)

屬性 類型 說明
address string 地址,已經(jīng)將省市區(qū)信息合并
name string 用戶姓名
tel string 座機(jī)號(hào)碼
mobile string 手機(jī)號(hào)碼

errCode 的合法值

說明 最低版本
0 成功

異常

Object

拋出的異常

屬性 類型 說明
errCode number 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

errCode 的合法值

說明 最低版本
-1 其他錯(cuò)誤
40199 運(yùn)單 ID 錯(cuò)誤,未查到運(yùn)單
9300507 Token 不正確

請(qǐng)求數(shù)據(jù)示例

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

返回?cái)?shù)據(jù)示例

{
  "waybillId": "12345678901234567890",
  "sender": {
    "address": "廣東省廣州市海珠區(qū)XX路XX號(hào)XX大廈XX棟XX",
    "name": "張三",
    "tel": "020-88888888",
    "mobile": "18666666666"
  },
  "receiver": {
    "address": "廣東省廣州市天河區(qū)XX路XX號(hào)XX大廈XX棟XX",
    "name": "王小蒙",
    "tel": "029-77777777",
    "mobile": "18610000000"
  },
  "errMsg": "openapi.logistics.getContact:ok"
}


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)