开放平台
  1. 实物商城-api对接-渠道方使用
开放平台
  • 加解签规则
  • 接口地址
  • 最福利物流编码
  • 渠道方
    • 实物商城-api对接-渠道方使用
      • 类目查询
        POST
      • 商品列表
        POST
      • 查询同类商品
        POST
      • 商品详情
        POST
      • 商品价格查询
        POST
      • 商品库存查询
        POST
      • 地址详情转换地址编码
        POST
      • 查询省市区收货地址编码
        POST
      • 商品下单
        POST
      • 商品物流轨迹
        POST
    • 订单系统
      • 确认订单(渠道信息作为用户信息)
      • 订单状态变更异步通知
      • 查询订单信息(用户为公司用户)
  1. 实物商城-api对接-渠道方使用

地址详情转换地址编码

开发中
测试环境
https://t-open.zuifuli.com
测试环境
https://t-open.zuifuli.com
POST
https://t-open.zuifuli.com
/api
应用场景#
根据地址详情转换为地址编码。该接口不能保证所有地址都匹配到地址编码,也不能保证所有匹配到的地址都正确。
因而,优先推荐使用省市区镇四级地址查询得到的地址信息。
接口信息#
serviceNamebase.address.convert
version1.0
请求****bizContent参数#
名称类型必填说明
addressString是地址详情,如北京市大兴区亦庄经济开发区经海路5号
响应bizContent参数#
名称类型必填说明
AddressVOAddressVO是查询结果
AddressVO#
名称类型必填说明
nationIdString是国家ID
nationString是国家名称
provinceIdInteger是一级地址ID
provinceString是一级地址名称
cityIdInteger是二级地址ID
cityString是二级地址名称
countyIdInteger是三级地址ID
countyString是三级地址名称
townIdInteger否四级地址ID
townString否四级地址名称
 {
		"provinceId": 1,
		"county": "亦庄经济开发区",
		"cityId": 2810,
		"province": "北京市",
		"townId": null,
		"town": null,
		"countyId": 51081,
		"nation": "中国",
		"city": "大兴区",
		"nationId": "4744"
}

请求参数

Body 参数application/x-www-form-urlencoded
channelCode
string 
渠道编号
必需
sign
string 
签名
必需
signType
string 
必需
签名类型,固定值MD5
示例值:
MD5
timestamp
string 
必需
请求时间,yyyy-MM-dd HH:mm:ss
bizContent
string 
必需
json字符串,具体业务参数
version
string 
版本号
必需
示例值:
1.0
serviceName
string 
服务名称
必需
示例值:
base.address.convert

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://t-open.zuifuli.com/api' \
--data-urlencode 'channelCode=' \
--data-urlencode 'sign=' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'timestamp=' \
--data-urlencode 'bizContent=' \
--data-urlencode 'version=1.0' \
--data-urlencode 'serviceName=base.address.convert'

返回响应

🟢200成功
application/json
Body
resultCode
string 
响应码,0为正常
必需
resultDesc
string 
响应描述
必需
timestamp
string 
响应时间
必需
bizContent
string 
必需
json字符串,具体内容见备注
示例
{
    "resultCode": "string",
    "resultDesc": "string",
    "timestamp": "string",
    "bizContent": "string"
}
上一页
商品库存查询
下一页
查询省市区收货地址编码
Built with