聚美智数


快递地址解析

<h3>接口描述</h3> <ul> <li>精准解析地址信息,并返回省、市、区、街道、详细地址、收件人、手机号等信息。</li> </ul> <h3>请求地址</h3> <p><code>https://api.jumdata.com/express/address-parse</code></p> <h3>请求方式</h3> <ul> <li>GET/POST</li> </ul> <h3>请求格式</h3> <ul> <li>x-www-form-urlencoded</li> </ul> <h3>请求参数</h3> <table> <thead> <tr> <th>名称</th> <th>类型</th> <th>必须</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>appId</td> <td>String</td> <td>是</td> <td>服务商分配的唯一标识</td> </tr> <tr> <td>timestamp</td> <td>Long</td> <td>是</td> <td>当前时间戳(毫秒数)</td> </tr> <tr> <td>sign</td> <td>String</td> <td>是</td> <td>签名,详见签名算法说明</td> </tr> <tr> <td>address</td> <td>String</td> <td>是</td> <td>地址信息</td> </tr> </tbody> </table> <h3>签名算法说明</h3> <p><code>sign = sha256(appId + appSecret + timestamp)</code></p> <p>用服务商分配的 appId、服务商分配的 appSecret,当前时间时间戳 timestamp,按上述顺序拼接成字符串,再进行 sha256 哈希得到。如下:</p> <pre><code class="language-java">String appId = &amp;quot;xyzxy2121zxyz&amp;quot;; String timestamp = &amp;quot;1555378976238&amp;quot;; String appSecret = &amp;quot;efcefcef1121cefcefc1212121&amp;quot;; String str = appId + appSecret + timestamp; String sign = sha256(str);</code></pre> <h3>成功返回样例</h3> <pre><code class="language-json">{ &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,//返回码对应描述 &amp;quot;code&amp;quot;: 200,//返回码,详见返回码说明 &amp;quot;taskNo&amp;quot;: &amp;quot;591593430181347812119657&amp;quot;,//本次请求号 &amp;quot;charge&amp;quot;: true,// 计费标志 &amp;quot;data&amp;quot;: { &amp;quot;province&amp;quot;: &amp;quot;福建省&amp;quot;,//省 &amp;quot;provinceCode&amp;quot;: &amp;quot;350000&amp;quot;,//省国标code &amp;quot;city&amp;quot;: &amp;quot;莆田市&amp;quot;,//市 &amp;quot;cityCode&amp;quot;: &amp;quot;350300&amp;quot;,//城市国标code &amp;quot;county&amp;quot;: &amp;quot;涵江区&amp;quot;,//区(县) &amp;quot;countyCode&amp;quot;: &amp;quot;350303&amp;quot;,//区县国标code &amp;quot;town&amp;quot;: &amp;quot;江口镇&amp;quot;,//街道(乡/镇) &amp;quot;townCode&amp;quot;: &amp;quot;350303104&amp;quot;,//街道/乡镇国标code &amp;quot;phoneNum&amp;quot;: &amp;quot;17286356303&amp;quot;,// 电话号码,如果出现多个则按顺序输出 &amp;quot;extMobile&amp;quot;: &amp;quot;1590&amp;quot;,//分机号 &amp;quot;person&amp;quot;: &amp;quot;小魏&amp;quot;,//姓名,如果出现多个则按顺序输出 &amp;quot;detail&amp;quot;: &amp;quot;石庭华侨职业中专丰巢柜&amp;quot; //详细地址 } } </code></pre> <h4>3.5 失败返回样例</h4> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 400, &amp;quot;msg&amp;quot;: &amp;quot;地址信息不能为空&amp;quot;, &amp;quot;charge&amp;quot;: false }</code></pre> <hr /> <h3>返回字段说明</h3> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>返回码,详见返回码说明</td> </tr> <tr> <td>msg</td> <td>code对应的描述</td> </tr> <tr> <td>charge</td> <td>计费标志</td> </tr> <tr> <td>taskNo</td> <td>本次请求号</td> </tr> <tr> <td>data</td> <td>返回具体结果,详见成功返回样例</td> </tr> </tbody> </table> <h4>code返回码说明</h4> <table> <thead> <tr> <th>code</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>成功(计费)</td> </tr> <tr> <td>400</td> <td>参数错误</td> </tr> <tr> <td>500</td> <td>系统维护,请稍候再试</td> </tr> <tr> <td>601</td> <td>接口未开通</td> </tr> <tr> <td>602</td> <td>账号停用</td> </tr> <tr> <td>603</td> <td>余额不足请充值</td> </tr> <tr> <td>604</td> <td>接口停用</td> </tr> <tr> <td>606</td> <td>调用超限,请稍候再试</td> </tr> <tr> <td>607</td> <td>ip不在白名单</td> </tr> <tr> <td>609</td> <td>请求过于频繁,请稍候再试</td> </tr> <tr> <td>610</td> <td>请求超时</td> </tr> <tr> <td>999</td> <td>其他,以实际返回为准</td> </tr> </tbody> </table>

页面列表

ITEM_HTML