校内地址查询
<h3>功能描述</h3>
<ul>
<li>根据学校id查询校内地址。
<h3>接入前须知</h3></li>
<li>请联系 王歆悦 进行校园验签key及默认下单人配置</li>
</ul>
<h3>接口定义</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">服务名称</th>
<th style="text-align: center;">批量交易</th>
<th style="text-align: center;">接口类型</th>
<th style="text-align: center;">接口uri</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">校内地址查询接口</td>
<td style="text-align: center;">不支持</td>
<td style="text-align: center;">接入/POST</td>
<td style="text-align: center;">/public/schoolPub/querySchoolAddress</td>
</tr>
</tbody>
</table>
<h3>请求</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型（约束）</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">默认值</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">schoolAppId</td>
<td style="text-align: center;">String</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">由校园系统方提供，用来单独验证</td>
</tr>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">addressType</td>
<td style="text-align: center;">Number (2)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">地址类型0校内地址1驿站</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">schoolId</td>
<td style="text-align: center;">Long</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">学校ID</td>
</tr>
</tbody>
</table>
<h3>响应</h3>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型（约束）</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">字段说明</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">msg</td>
<td style="text-align: center;">String (200)</td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">信息</td>
<td style="text-align: left;">提示信息</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">succ</td>
<td style="text-align: center;">String (10)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">状态码</td>
<td style="text-align: left;">返回成功或失败信息(ok/fail)</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">result</td>
<td style="text-align: center;">List<SchoolAddressSettingEntity> (/)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">数据</td>
<td style="text-align: left;">数据，可能为空</td>
</tr>
</tbody>
</table>
<h4>响应result<List></h4>
<h5>SchoolAddressSettingEntity</h5>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">字段说明</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">schoolId</td>
<td style="text-align: center;">String(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">学校ID</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">schoolName</td>
<td style="text-align: center;">String(50)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">所属学校名称</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">addressTree</td>
<td style="text-align: center;">List<SchoolAddressTreeEntity></td>
<td style="text-align: center;">否</td>
<td style="text-align: center;">地址集合</td>
</tr>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">addressType</td>
<td style="text-align: center;">Number (2)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">地址类型0其他1驿站</td>
</tr>
</tbody>
</table>
<h5>SchoolAddressTreeEntity</h5>
<table>
<thead>
<tr>
<th style="text-align: center;">序号</th>
<th style="text-align: center;">字段名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: center;">字段说明</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center;">1</td>
<td style="text-align: center;">address</td>
<td style="text-align: center;">String(64)</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">地址名称</td>
</tr>
<tr>
<td style="text-align: center;">2</td>
<td style="text-align: center;">level</td>
<td style="text-align: center;">Integer</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">地址等级0开始</td>
</tr>
<tr>
<td style="text-align: center;">3</td>
<td style="text-align: center;">parentId</td>
<td style="text-align: center;">Long</td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">上级id</td>
</tr>
<tr>
<td style="text-align: center;">4</td>
<td style="text-align: center;">children</td>
<td style="text-align: center;">List<SchoolAddressTreeEntity></td>
<td style="text-align: center;">是</td>
<td style="text-align: center;">数据</td>
<td style="text-align: left;">数据，可能为空</td>
</tr>
</tbody>
</table>
<h3>报文范例</h3>
<ul>
<li>
<p><strong>请求报文</strong></p>
<pre><code>{&quot;schoolAppId&quot;:&quot;a&quot;,&quot;schoolId&quot;:&quot;884328609426243584&quot;,&quot;addressType&quot;:0}</code></pre>
</li>
<li><strong>响应报文</strong>
<ul>
<li>成功报文
<pre><code>{
&quot;result&quot;: [{
&quot;id&quot;: 978916445740011520,
&quot;schoolId&quot;: 884328609426243584,
&quot;schoolName&quot;: &quot;测试学校&quot;,
&quot;addressType&quot;: 1,
&quot;modifierUser&quot;: &quot;12301230050&quot;,
&quot;modifyTm&quot;: &quot;2024-08-03 17:53:16&quot;,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:11:18&quot;,
&quot;addressTree&quot;: [{
&quot;id&quot;: 978916445740011521,
&quot;addressId&quot;: 978916445740011520,
&quot;address&quot;: &quot;驿站之顺丰驿站牛&quot;,
&quot;level&quot;: 0,
&quot;parentId&quot;: null,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:11:18&quot;,
&quot;children&quot;: [{
&quot;id&quot;: 978916445740011522,
&quot;addressId&quot;: 978916445740011520,
&quot;address&quot;: &quot;驿站子节点子牛牛&quot;,
&quot;level&quot;: 1,
&quot;parentId&quot;: 978916445740011521,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:11:18&quot;,
&quot;children&quot;: []
}]
},
{
&quot;id&quot;: 978916445740011523,
&quot;addressId&quot;: 978916445740011520,
&quot;address&quot;: &quot;驿站2&quot;,
&quot;level&quot;: 0,
&quot;parentId&quot;: null,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:11:18&quot;,
&quot;children&quot;: [{
&quot;id&quot;: 978916445740011524,
&quot;addressId&quot;: 978916445740011520,
&quot;address&quot;: &quot;驿站子节点2&quot;,
&quot;level&quot;: 1,
&quot;parentId&quot;: 978916445740011523,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:11:18&quot;,
&quot;children&quot;: []
},
{
&quot;id&quot;: 978917744165810176,
&quot;addressId&quot;: 978916445740011520,
&quot;address&quot;: &quot;初始大口径的坑&quot;,
&quot;level&quot;: 1,
&quot;parentId&quot;: 978916445740011523,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:16:28&quot;,
&quot;children&quot;: []
}
]
},
{
&quot;id&quot;: 978917819541647360,
&quot;addressId&quot;: 978916445740011520,
&quot;address&quot;: &quot;初始3&quot;,
&quot;level&quot;: 0,
&quot;parentId&quot;: null,
&quot;createUser&quot;: &quot;18320628999&quot;,
&quot;createTm&quot;: &quot;2024-08-01 17:16:46&quot;,
&quot;children&quot;: []
}
]
}],
&quot;succ&quot;: &quot;ok&quot;,
&quot;msg&quot;: null,
&quot;extendResult&quot;: null
}</code></pre></li>
<li>失败报文-范例1
<pre><code>{
&quot;result&quot;: null,
&quot;succ&quot;: &quot;fail&quot;,
&quot;msg&quot;: &quot;所选订单类型不存在&quot;
}</code></pre></li>
<li>失败报文-范例2
<pre><code>{
&quot;msg&quot;:&quot;未校验到下单人数据&quot;,
&quot;result&quot;: null,
&quot;succ&quot;: &quot;fail&quot;
}</code></pre></li>
</ul></li>
</ul>