智能地址解析
上新智能地址解析:粘贴文本自动提取姓名、电话、省市区与详细地址
智能地址解析:传入一段含收货人/电话/地址的粘贴文本,自动拆出姓名、手机号、省市区与详细地址。
上游为阿里云地址标准化「物流面单信息提取」(ExtractExpress)。
典型场景:电商下单页粘贴地址一键填表、ERP/仓储录单、客服工单结构化。
上游为阿里云地址标准化「物流面单信息提取」(ExtractExpress)。
典型场景:电商下单页粘贴地址一键填表、ERP/仓储录单、客服工单结构化。
调用地址:https://api.ynlskj.com.cn/gateway/addrparse
请求方法:POST
在其他地方怎么调用
- 请求地址用上面的调用地址,把 JSON 放在请求体里
- 方法用
POST - API Key 只能放在请求头
X-API-Key,不要写进网址,也不要写进 Query 框 - Key 在「个人中心 → API Key」里复制,登录后会自动填入你自己的 Key
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
text | Body JSON | 是 | 含收货人/电话/地址的粘贴文本,最长 2000 字。也可用 content / address |
province | Body JSON | 否 | 默认省份,辅助缺省地址补全。也可用 default_province |
city | Body JSON | 否 | 默认城市。也可用 default_city |
district | Body JSON | 否 | 默认区县。也可用 default_district |
X-API-Key | Header | 是 | 你的 API Key |
请求示例
| 场景 | Body 示例 |
|---|---|
| 粘贴一整段 | {"text":"张三 13800138000 云南省昆明市五华区人民中路100号"} |
| 带标签文本 | {"text":"收货人:李四;手机:13912345678;地址:杭州市余杭区文一西路969号"} |
| 补默认省市 | {"text":"王五 13700001111 五华区某某路1号","province":"云南省","city":"昆明市"} |
上游为阿里云「物流面单信息提取」。返回字段已统一为 name / mobile / province / city / district / detail;原始片段在 raw_extract。
返回说明
| 字段 | 说明 |
|---|---|
ret | ok 成功,err 失败 |
data.name | 收货人姓名 |
data.mobile | 11 位手机号(能识别时) |
data.phone | 原始电话文本(可能含固话) |
data.province / city / district / town | 省 / 市 / 区 / 街道乡镇 |
data.detail | 详细地址(路名门牌等) |
data.full_address | 拼接后的完整地址 |
data.raw_extract | 上游原始抽取字段,便于排查 |
msg | 本站提示,如「次数充足,剩余 99 次」或「次数不足,剩余 0 次」 |
remain_quota | 本次调用后的剩余次数 |
可直接复制的代码
未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key,不会展示别人的。
<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/addrparse');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{
"text": "张三 13800138000 云南省昆明市五华区人民中路100号附1号"
}',
]);
echo curl_exec($ch);
请求参数演示
{"text":"张三 13800138000 云南省昆明市五华区人民中路100号附1号"}
响应演示
{"ret":"ok","code":200,"errmsg":"成功","data":{"name":"张三","mobile":"13800138000","phone":"13800138000","province":"云南省","city":"昆明市","district":"五华区","town":"","detail":"人民中路100号附1号","full_address":"云南省昆明市五华区人民中路100号附1号","text":"张三 13800138000 云南省昆明市五华区人民中路100号附1号","status":"OK","request_id":"demo-request-id","raw_extract":{"per":"张三","tel":"13800138000","prov":"云南省","city":"昆明市","district":"五华区","town":"","addr_info":"人民中路100号附1号"}}}