LanTongSystem-接口文档

澜通云系统服务接口说明


新增出行人

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>新增出行人信息</li> <li>测试环境:<a href="http://119.8.54.173">http://119.8.54.173</a></li> <li>生产环境:<a href="https://ms.lantoncloud.com">https://ms.lantoncloud.com</a></li> </ul> <h5>请求URL</h5> <ul> <li>/lantong-system/systemExternal/saveContact</li> </ul> <h5>请求方式</h5> <ul> <li>requestMethod: POST</li> </ul> <h5>请求参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">说明</th> <th style="text-align: left;">必选</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">contact</td> <td style="text-align: left;">出行人信息json格式,详细参数及请求示例如下</td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">areaId</td> <td style="text-align: left;">国家/地区</td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">birthday</td> <td style="text-align: left;">生日</td> <td style="text-align: left;">是</td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">contactsId</td> <td style="text-align: left;">会员联系人</td> <td style="text-align: left;">否</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">contactIdList</td> <td style="text-align: left;">证件信息</td> <td style="text-align: left;">是</td> <td>ContactId对象</td> </tr> <tr> <td style="text-align: left;">contactsId</td> <td style="text-align: left;">联系人id</td> <td style="text-align: left;">否</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">expiryDate</td> <td style="text-align: left;">证件到期时间</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">idNumber</td> <td style="text-align: left;">证件号</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">idType</td> <td style="text-align: left;">证件类型</td> <td style="text-align: left;">否</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">isDeleted</td> <td style="text-align: left;">是否已删除</td> <td style="text-align: left;">否</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">issueAt</td> <td style="text-align: left;">证件签发地</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">业务状态</td> <td style="text-align: left;">否</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">expiryDate</td> <td style="text-align: left;"></td> <td style="text-align: left;">否</td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">firstName</td> <td style="text-align: left;">英文姓</td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">gender</td> <td style="text-align: left;">性别(1:男,2:女)</td> <td style="text-align: left;">是</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">idNo</td> <td style="text-align: left;"></td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">idNoExpiryDate</td> <td style="text-align: left;"></td> <td style="text-align: left;">是</td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">idNoIssueAt</td> <td style="text-align: left;"></td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">issueAt</td> <td style="text-align: left;"></td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">lastName</td> <td style="text-align: left;">英文名</td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">memberId</td> <td style="text-align: left;">会员id</td> <td style="text-align: left;">是</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">nameCn</td> <td style="text-align: left;">中文姓名</td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">otherNo</td> <td style="text-align: left;"></td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">otherNoExpiryDate</td> <td style="text-align: left;"></td> <td style="text-align: left;">否</td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">otherNoIssueAt</td> <td style="text-align: left;"></td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">passportNo</td> <td style="text-align: left;"></td> <td style="text-align: left;">是</td> <td>string</td> </tr> <tr> <td style="text-align: left;">phone</td> <td style="text-align: left;">手机号</td> <td style="text-align: left;">否</td> <td>string</td> </tr> <tr> <td style="text-align: left;">phoneCode</td> <td style="text-align: left;">手机区号</td> <td style="text-align: left;">否</td> <td>string</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code class="language-java">{ "birthday": "1981-01-01", "passportNo": "430525200104285113", "lastName": "ZHOU", "gender": "1", "nameCn": "周", "idNo": "", "idNoExpiryDate": "", "expiryDate": "2034-01-16", "firstName": "ZHOU", "areaId": "+86", "contactIdList": [ { "expiryDate": "2034-01-16", "idType": "2", "issueAt": "+86", "idNumber": "430525200104285113" } ], "otherNoIssueAt": "", "phone": "12345678912", "phoneCode": "+86", "idNoIssueAt": "", "issueAt": "+86", "otherNoExpiryDate": "", "otherNo": "", "memberId": "1564502778804473857" }</code></pre> <h5>返回示例</h5> <pre><code>{ "code": 200, "success": true, "data": { "birthday": "1981-01-01", "passportNo": "430525200104285114", "lastName": "ZHOU", "gender": "1", "nameCn": "周", "idNo": "", "idNoExpiryDate": "", "expiryDate": "2034-01-16", "firstName": "ZHOU", "areaId": "+86", "contactIdList": [ { "expiryDate": "2034-01-16", "idType": "2", "issueAt": "+86", "idNumber": "430525200104285114" } ], "otherNoIssueAt": "", "phone": "12345678912", "phoneCode": "+86", "idNoIssueAt": "", "issueAt": "+86", "otherNoExpiryDate": "", "otherNo": "", "memberId": "1564502778804473857" }, "msg": "操作成功" } </code></pre> <h5>返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">说明</th> <th>类型</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">状态码</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">承载数据</td> <td>object</td> </tr> <tr> <td style="text-align: left;">success</td> <td style="text-align: left;">是否成功</td> <td>boolean</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">返回消息</td> <td>string</td> </tr> <tr> <td style="text-align: left;">contact</td> <td style="text-align: left;">会员常用联系人 body</td> <td>MemberContacts对象_1</td> </tr> <tr> <td style="text-align: left;">areaId</td> <td style="text-align: left;">国家/地区</td> <td>string</td> </tr> <tr> <td style="text-align: left;">birthday</td> <td style="text-align: left;">生日</td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">contactsId</td> <td style="text-align: left;">会员联系人</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">contactIdList</td> <td style="text-align: left;">证件信息</td> <td>ContactId对象</td> </tr> <tr> <td style="text-align: left;">contactsId</td> <td style="text-align: left;">联系人id</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">expiryDate</td> <td style="text-align: left;">证件到期时间</td> <td>string</td> </tr> <tr> <td style="text-align: left;">idNumber</td> <td style="text-align: left;">证件号</td> <td>string</td> </tr> <tr> <td style="text-align: left;">idType</td> <td style="text-align: left;">证件类型</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">isDeleted</td> <td style="text-align: left;">是否已删除</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">issueAt</td> <td style="text-align: left;">证件签发地</td> <td>string</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">业务状态</td> <td>integer</td> </tr> <tr> <td style="text-align: left;">expiryDate</td> <td style="text-align: left;"></td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">firstName</td> <td style="text-align: left;">英文姓</td> <td>string</td> </tr> <tr> <td style="text-align: left;">gender</td> <td style="text-align: left;">性别(1:男,2:女)</td> <td>integer(int32)</td> </tr> <tr> <td style="text-align: left;">idNo</td> <td style="text-align: left;"></td> <td>string</td> </tr> <tr> <td style="text-align: left;">idNoExpiryDate</td> <td style="text-align: left;"></td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">idNoIssueAt</td> <td style="text-align: left;"></td> <td>string</td> </tr> <tr> <td style="text-align: left;">issueAt</td> <td style="text-align: left;"></td> <td>string</td> </tr> <tr> <td style="text-align: left;">lastName</td> <td style="text-align: left;">英文名</td> <td>string</td> </tr> <tr> <td style="text-align: left;">memberId</td> <td style="text-align: left;">会员id</td> <td>integer(int64)</td> </tr> <tr> <td style="text-align: left;">nameCn</td> <td style="text-align: left;">中文姓名</td> <td>string</td> </tr> <tr> <td style="text-align: left;">otherNo</td> <td style="text-align: left;"></td> <td>string</td> </tr> <tr> <td style="text-align: left;">otherNoExpiryDate</td> <td style="text-align: left;"></td> <td>string(date)</td> </tr> <tr> <td style="text-align: left;">otherNoIssueAt</td> <td style="text-align: left;"></td> <td>string</td> </tr> <tr> <td style="text-align: left;">passportNo</td> <td style="text-align: left;"></td> <td>string</td> </tr> <tr> <td style="text-align: left;">phone</td> <td style="text-align: left;">手机号</td> <td>string</td> </tr> <tr> <td style="text-align: left;">phoneCode</td> <td style="text-align: left;">手机区号</td> <td>string</td> </tr> </tbody> </table> <h5>code码说明</h5> <table> <thead> <tr> <th style="text-align: left;">code</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">200</td> <td style="text-align: left;">成功</td> </tr> <tr> <td style="text-align: left;">201</td> <td style="text-align: left;">参数校验失败</td> </tr> <tr> <td style="text-align: left;">102</td> <td style="text-align: left;">会员不存在</td> </tr> <tr> <td style="text-align: left;">500</td> <td style="text-align: left;">加载失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML