### 使用描述【已弃用】 根据地址详情转换为聚合供应链地址编码。该接口不能保证所有地址都匹配到聚合供应链地址，也不能保证所有匹配到的聚合供应链地址都正确。因而，优先推荐使用逐级选择的方法 ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E6%96%B9%E6%B3%95%E5%90%8D)方法名 dby.scm.address.convert ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E7%BD%91%E5%85%B3%E5%9C%B0%E5%9D%80)网关地址 | 环境 | 地址 | 请求方式 | | --- | --- | --- | | 生产环境 | `https://openapi.duobaoyu.com.cn/open/api` | post+json | | 测试环境 | `https://openapi.duobaoyu88.cn/open/api` | post+json | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E5%85%AC%E5%85%B1query%E5%8F%82%E6%95%B0)公共Query参数 * * * | 名称 | 类型 | 必填 | 描述 | | --- | --- | --- | --- | | method | String | 是 | 方法名称 | | sign | String | 是 | [签名](签名规则.md) | | timestamp | String | 是 | 时间戳,格式为13位,例如:1670223623000 | | version | String | 是 | 版本号,现固定位v1 | | appKey | String | 是 | 申请的应用appKey | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E4%B8%9A%E5%8A%A1body%E5%8F%82%E6%95%B0applicationjson)业务Body参数(application/json) * * * | 名称 | 类型 | 必填 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | addressDetail | java.lang.String | 是 | 湖北省武汉市武昌区川岚大厦 | 详细地址 （地址中请包含城市名称，否则会影响准确度） | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0)响应参数 * * * | 名称 | 类型 | 示例值 | 描述 | | --- | --- | --- | --- | | code | java.lang.String | 0 | 业务编码处理结果编码 | | msg | java.lang.String | 请求成功 | 业务处理结果结果说明 | | data | java.lang.Object | | 响应结果 | |   ├─provinceName | java.lang.String | 湖北省 | 省份 | |   ├─provinceCode | java.lang.String | 42 | 省份编码 | |   ├─cityName | java.lang.String | 武汉市 | 城市 | |   ├─cityCode | java.lang.String | 4201 | 城市编码 | |   ├─countyName | java.lang.String | 武昌区 | 区/县 | |   ├─countyCode | java.lang.String | 420106 | 区/县/编码 | |   ├─townName | java.lang.String | 首义路街道 | 街道/镇 | |   ├─townCode | java.lang.String | 420106010 | 街道/镇编码 | | msgId | java.lang.String | efd7f07011124adf | 消息id | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B)请求示例 curljavaphp ~~~json curl -XPOST -H "Content-type: application/json" -d '{ "addressDetail": "湖北省武汉市武昌区川岚大厦" }' 'http://xxxxx/open/api?method=dby.scm.address.convert&version=v1&appKey=123456&timestamp=1670057525000&sign=d8cf6b990f1ef5b67d4458a35773cee5' ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B)响应示例 ~~~json { "code": "0", "msg": "请求成功", "data": { "provinceName": "湖北省", "provinceCode": "42", "cityName": "武汉市", "cityCode": "4201", "countyName": "武昌区", "countyCode": "420106", "townName": "首义路街道", "townCode": "420106010" }, "msgId": "3d0211b28acf4e0a" } ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=c4a67cf9bbd14b411e2fe15bd627d452#%E5%BC%82%E5%B8%B8%E7%A4%BA%E4%BE%8B)异常示例 ~~~json { "code": "1", "msg": "请求失败", "data": null, "msgId": "efd7f07011124adf" } ~~~