第1个回答 2022-08-01
新增密文下单购买礼品
1、v兔的礼品商城新增了密文下单购买礼品，不需要商家再倒来倒去表格了。请先各位大佬先大致浏览一下全篇文章，先有大致的情况介绍，再看接口文档会方便很多。
2、如果需要通过密文进行下单购买礼品的话，需要看一下关于密文调用接口文档发货的礼品调用的
3、首先要确定下单的礼品是否支持密文，大部分的快递仓库是支持密文打单的，但是如顺丰的一些仓库是不支持的。如顺丰湖南仓，但是如顺丰关东仓-丰网是支持密文的无论是仓库列表的接口还是商品的列表的接口都会有字段表明该仓库或则该商品是否支持密文传，is_encryption。
OAID 解密
接口地址：juzivtu
接口介绍： 解码 OAID(Open Addressee ID)，返回收件人信息。点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 请求次数收费，联系运营
频率限制： 10 次/秒
请求头参数
参数 类型 必选 值 示例
Authorization string 是 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx
请求参数
参数 类型 必选 描述
shop_id INT 必填 店铺 id
query_list ReceiverQuery[] true 解密请求列表，最多支持 20 个。
oaid String true xxxxxx 收件人 ID (Open Addressee ID)，长度在 128 个字符之内。
tid String true 12345678 交易订单 ID
scene String true 1005 解密场景编号。不同场景，解密策略不同。请根据产品功能选择相应的场景编号。可选的场景：1001(顺丰电子面单发货)、1002(4 通一达电子面单发货)、1003(EMS 电子面单发货)、1004(其他电子面单发货)、1005(线下门店发货)、1006(手工单发货)、1007(代发货)、2001(客户售后服务)、2002(客户关怀)，详情点击
vvtype INT 非必填 不传默认 1 只支持 1
请求示例
{ { "shop_id": "121321321", "query_list": [ { "oaid": "1RJ84QYqfsUw5SQE2OEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "tid": "240252879XXXXXXXXXXXXXXXXX", "scene": "1002" } ] } }
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
名称 类型 示例值 描述
receiver_list Receiver [] 收件人列表
name String 张三 收件人的姓名
mobile String 13012345678 收件人的手机号，privacy_protection=true 是为隐私号，格式为 18877771111-123
address_detail String 淘宝城 911 号 收件人的详细地址
phone String 010-12345678 收件人的电话号码
oaid String xxxx 收件人 ID (Open Addressee ID)，长度在 128 个字符之内。
tid String 123456 交易编号
town String 三墎镇 收货人街道地址
district String 西湖区 收货人的所在地区
city String 杭州市 收货人的所在城市
state String 浙江省 收货人的所在省份
country String 中国 收货人国籍
matched Boolean true oaid 是否和 tid 当前的 oaid 匹配。true：匹配，false：不匹配。当不匹配时，建议通过 taobao.trade.fullinfo.get 获取最新的 oaid。
secret_no_expire_time Date 2021-09-01 00:00:00 隐私号过期时间，privacy_protection=true 时有值
privacy_protection Boolean true 标记订单是否为隐私保护订单，为 true 时，mobile 为隐私号
withholding_money int 该接口扣费金额（点券）