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