2.接口说明
<p>[TOC]</p>
<h3>2.接口说明</h3>
<h4>2.1. 单点登录相关接口</h4>
<h5>2.1.1. 获取授权码</h5>
<ul>
<li>用户注册接口</li>
</ul>
<h6>请求URL</h6>
<ul>
<li><code>https://auths-test.dysmt.cn/oauth/authorize</code></li>
</ul>
<h6>请求方式</h6>
<ul>
<li>GET </li>
</ul>
<h6>参数</h6>
<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;">client_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方系统唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">response_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>固定值=code</td>
</tr>
<tr>
<td style="text-align: left;">grant_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>固定值=authorization_code</td>
</tr>
<tr>
<td style="text-align: left;">scope</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>固定值，参看 2.1.2 scope 作用域说明</td>
</tr>
<tr>
<td style="text-align: left;">redirect_uri</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>授权后重定向的回调链接地址，此参数需要放在后面</td>
</tr>
</tbody>
</table>
<h6>入参示例</h6>
<pre><code>https://auths-test.dysmt.cn/oauth/authorize?client_id=057ffa40*******f9b9bac69dc4c8d&response_type=code&grant_type=authorization_code&scope=snsapi_userinfo&redirect_uri=http://127.0.0.1/</code></pre>
<h6>返回示例</h6>
<pre><code> {
"error_code": 0,
"data": {
"uid": "1",
"username": "12154545",
"name": "吴系挂",
"groupid": 2 ,
"reg_time": "1436864169",
"last_login_time": "0",
}
}</code></pre>
<h6>返回示例</h6>
<pre><code>redirect_uri?code=CODE&state=STATE用户允许授权后，将会重定向到 redirect_uri 的网址上，并且带上 code 参数。</code></pre>
<h6>返回参数说明</h6>
<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;">string</td>
<td>授权码，用于后台获取 access_token</td>
</tr>
</tbody>
</table>
<h5>2.1.2. 接口作用域（scope）说明</h5>
<p>对于接口作用域（scope），能调用的接口有以下</p>
<h6>参数</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">snsapi_base</td>
<td style="text-align: left;">/resource/user/base</td>
<td style="text-align: left;">只包括用户 id,用户名</td>
</tr>
<tr>
<td style="text-align: left;">snsapi_baseinfo</td>
<td style="text-align: left;">/resource/user/info</td>
<td style="text-align: left;">用户基本信息</td>
</tr>
<tr>
<td style="text-align: left;">snsapi_userinfo</td>
<td style="text-align: left;">/resource/user/info</td>
<td style="text-align: left;">用户基本信息和敏感信息(身份证,认证资料,资料库等)</td>
</tr>
</tbody>
</table>
<h6>常见问题</h6>
<h6>什么是授权临时票据（code）？</h6>
<ul>
<li>答：第三方通过 code 进行获取 access_token 的时候需要用到，code 的超时时间为 10 分钟，一个 code 只能成功换取一次 access_token 即失效。code 的临时性和一次保障了平台授权登录的安全性。第三方可通过使用 https 和 state 参数，进一步加强自身授权登录的安全性。</li>
</ul>
<h6>什么是授权作用域（scope）？</h6>
<ul>
<li>答：授权作用域（scope）代表用户授权给第三方的接口权限，第三方应用需要向平台申请使用相应 scope 的权限后，使用文档所述方式让用户进行授权，经过用户授权，获取到相应 access_token 后方可对接口进行调用。</li>
</ul>
<h5>2.1.3. 获取 access_token</h5>
<h6>简要描述：</h6>
<p>采用 OAuth2.0 的授权码模式，根据授权码获取 access_token</p>
<h6>请求 URL：</h6>
<p>测试环境地址</p>
<ul>
<li><code>https://auths-test.dysmt.cn/oauth/token</code></li>
</ul>
<h6>请求方式：</h6>
<ul>
<li>POST </li>
</ul>
<h6>请求参数：</h6>
<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;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>填写第一步获取的 code 参数</td>
</tr>
<tr>
<td style="text-align: left;">client_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方系统唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">client_secret</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方系统密钥</td>
</tr>
<tr>
<td style="text-align: left;">grant_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>固定值=authorization_code</td>
</tr>
<tr>
<td style="text-align: left;">redirect_uri</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>回调地址,必须与上一步一致。</td>
</tr>
<tr>
<td style="text-align: left;">redirect_uri</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>授权后重定向的回调链接地址，此参数需要放在后面</td>
</tr>
</tbody>
</table>
<h6>入参示例:</h6>
<pre><code>https://auths-test.dysmt.cn/oauth/token?code=uknIS1&client_id=057ffa40*******f9b9bac69dc4c8d&client_secret=2faa6ccb0ca*********a8c7aa31c5c&grant_type=authorization_code&redirect_uri=http://127.0.0.1/</code></pre>
<h6>返回示例：</h6>
<pre><code>{
"access_token": "ACCESS_TOKEN",
"token_type": "bearer",
"refresh_token": "REFRESH_TOKEN",
"expires_in": 604799,
"scope": "snsapi_base",
"roles": [
{
"authority": "ROLE_USER"
}
],
"userName": "188xxxxxxxx",
"userId": "0854579e9cea4be98c6122c9f0671xxx",
"jti": "1578a3e2-26a4-4252-8a54-0c44a7447xxx"
}</code></pre>
<h6>返回参数说明：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Access_token</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">接口调用凭证</td>
</tr>
<tr>
<td style="text-align: left;">Refresh_token</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户刷新access_token</td>
</tr>
<tr>
<td style="text-align: left;">Expires_in</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">access_token 接口调用凭证超时时间，单位（秒）</td>
</tr>
<tr>
<td style="text-align: left;">scope</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户授权的作用域，使用逗号（,）分隔</td>
</tr>
<tr>
<td style="text-align: left;">roles</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">角色(ROLE_USER,ROLE_CLIENT)</td>
</tr>
<tr>
<td style="text-align: left;">userName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户名</td>
</tr>
<tr>
<td style="text-align: left;">userId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户ID号</td>
</tr>
</tbody>
</table>
<h5>2.1.4. 获取用户基础信息</h5>
<h6>简要描述：</h6>
<p>返回的仅有基础信息（用户id及用户名）</p>
<h6>请求测试环境地址 URL：</h6>
<pre><code>https://authr-test.dysmt.cn/resource/user/base?access_token=授权token</code></pre>
<h6>请求方式：</h6>
<ul>
<li>POST</li>
</ul>
<h6>请求参数：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Access_token</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">授权码，用于后台获取 access_token</td>
</tr>
</tbody>
</table>
<h6>返回示例：</h6>
<pre><code>{
"status": 1,
"code": 0,
"content": {
"id": "0854579e9cea4be98c6122c9f0671xxx",
"nickname": "修改昵称",
"photoUrl": null,
"phone": "188xxxxxxxx",
"gender": 1
},
"message": null
}</code></pre>
<h6>返回参数说明：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户标识</td>
</tr>
<tr>
<td style="text-align: left;">nickname</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">昵称</td>
</tr>
<tr>
<td style="text-align: left;">gender</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">性别(1:男 2:女 3:未知）</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">电话信息</td>
</tr>
<tr>
<td style="text-align: left;">phoneUrl</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">头像图片链接</td>
</tr>
</tbody>
</table>
<h5>2.1.5. 获取用户基本信息</h5>
<h5>简要描述：</h5>
<p>返回的用户的基本信息</p>
<h6>请求测试环境地址 URL：</h6>
<pre><code>https://authr-test.dysmt.cn/resource/user/baseinfo?access_token=授权 token
</code></pre>
<h6>请求方式：</h6>
<ul>
<li>POST</li>
</ul>
<h6>请求参数：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">授权码，用于后台获取 access_token</td>
</tr>
</tbody>
</table>
<h6>入参示例：</h6>
<pre><code>https://authr-test.dysmt.cn/resource/user/baseinfo?access_token=授权 token
</code></pre>
<h6>返回参数说明：</h6>
<pre><code>"status": 1,
"code": 0,
"content": {
"id": "8b36ace6fdfe42819e6a6511ecf57xxx",
"nickname": "wchao",
"photoUrl": "http://59.61.216.120/group1/M00/28/B0/wKjLQ1zCarGAHuxfAAOosIzxPBsxxx.jpg",
"phone": "187xxxxxxxx",
"gender": 1,
"name": "",
"telephone": "",
"email": "",
"accountStatus": 0,
"userGrade": 0,
"address": "",
"zipCode": null,
"introduction": "",
"residentProvinceCode": null,
"residentCityCode": null,
"residentCountyCode": null,
"isUserAuth": 0,
"isEnterprise": 0,
"isAgent": 0,
"appId": "b58f8d40f3204515aa605274d7aadxxx",
"userAccountId": "8b36ace6fdfe42819e6a6511ecf57xxx",
"userToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpblRpbWUiOjE1NjM4NjI5ODI3OTksInVzZXJJZCI6IjhiMzZhY2U2ZmRmZTQyODE5ZTZhNjUxMWVjZjU3OGU2In0.CRoyyGgUd2SQ4zSdRda4hNa-KiQxlQg6d1ges8v-cQCkdQ20Kx-wySlgWFfzPmkAtnbkIja_qM8a_2mPTuHoRh5Cfhr43jNDWI_zbUN_ERJtDo0Q1pRhCmNTmYEwGTWNEqnj8tf3VSOrK2oOZEhhDcIwmcRjnAGEfbHwZ9yA_TE1pWcbJ6wWaAMA2B-JkSl205xLzM34nQQBO8KNAxg0JSBoJaEZVQ4E0hp-4wR1VpK3Hx-61c-It_K-f74TCW0KcLmBhYmJI1_CEplQ4WGWsqhx_uLYnJUnRxmVJLOkFheYszwXyYgAOLIeFw4HQqckm1OHDiMATX4C0F5hIqnmkw"
},
"message": null</code></pre>
<h6>返回主要参数</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户标识</td>
</tr>
<tr>
<td style="text-align: left;">nickname</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">昵称</td>
</tr>
<tr>
<td style="text-align: left;">gender</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">性别(1:男 2:女 3:未知）</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">电话信息</td>
</tr>
<tr>
<td style="text-align: left;">phoneUrl</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">头像图片链接</td>
</tr>
<tr>
<td style="text-align: left;">userToken</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户token</td>
</tr>
</tbody>
</table>
<h5>2.1.5. 获取用户认证信息</h5>
<p>#######简要描述：
获取用户基本信息和敏感信息(身份证,认证资料,资料库等)</p>
<h6>请求测试环境地址 URL：</h6>
<p>-<code>https://authr-test.dysmt.cn/resource/user/userinfo?ccess_token=授权 token</code></p>
<h6>请求方式：</h6>
<ul>
<li>POST
<h6>请求参数</h6></li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">授权码，用于后台获取 access_token</td>
</tr>
</tbody>
</table>
<h6>返回参数：</h6>
<pre><code>"status": 1,
"code": 0,
"content": {
"id": "64205d3a29454b658d94af6b59495xxx",
"nickname": "邵 X",
"photoUrl": null,
"phone": "188XXXXXXXX ",
"gender": 0,
"name": "邵隆",
"telephone": "",
"email": "",
"accountStatus": 0,
"userGrade": 0,
"address": "",
"zipCode": null,
"introduction": "",
"residentProvinceCode": null,
"residentCityCode": null,
"residentCountyCode": null,
"isUserAuth": 0,
"isEnterprise": 0,
"isAgent": 0,
"appId": "37311cbb2d594e7ea9eb88fad7e90xxx",
"userAccountId": "f9d22fbeb23746878dc62eecef1c1xxx",
"userToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJsb2dpblRpbW
UiOjE1NzExOTE3ODAxMjYsInVzZXJJZCI6IjY0MjA1ZDNhMjk0NTRiNjU4ZDk0YWY2YjU
5NDk1NGM4IiwiYWNjb3VudFVzZXJJZCI6ImY5ZDIyZmJlYjIzNzQ2ODc4ZGM2MmVlY2Vm
MWMxNzIzIn0.O6N0j1H25lKMDjf3yvKxO34ETwcxmI_xbDF7g6YWf5plqWPjjKjI64Kua
3A7uYZeiVEhXLJkPFV9lYWLTefAbHatG0_KoAcs-UpSIfpqRJ3SheEuJT9X9rWexO9RDC
0m4omoVSefE78FlPcIhe1R6qBK-C-H4FyaCSBibwFiM0AHLJmfShFEIkmmW5A2ZALOIZM
D9xGhG6t4qlFN3LuA4Imn5P4PyEjNbyv1K6E-Mj5PuK99wyu9lDHQZs1_LmruUkeh0PMS
vcqU3N9QSldG3PAEDyLTa_WAyJthRRpw_AeMagLsnAiXt5eVMOnS8lMD3ZdthM1yx0Cub
nJeXXXXX",
"userAuth": {
"realName": "邵 X",
"cardId": "350502XXXXXXXXXXXXX ",
"cardType": 0,
"cardTypeCn": null,
"status": 2,
"cardFrontPicUrl": null,
"cardBackPicUrl": null,
"cardFrontBase64": null,
"cardBackBase64": null
},
"enterAuth": {
"enterName": "1255",
"licenseId": null,
"licenseProvince": "四川省",
"licenseCity": "德阳市",
"licenseCounty": "旌阳区区",
"address": "希望财富中心",
"licenseValidYmd": null,
"licenseIsForeverValid": false,
"managementScope": "",
"orgId": "1255",
"orgPicId": null,
"orgType": 0,
"orgTypeName": null,
"corporationName": "邵",
"corporationCardType": 0,
"corpora
}
</code></pre>
<h6>返参说明</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户标识</td>
</tr>
<tr>
<td style="text-align: left;">nickname</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">昵称</td>
</tr>
<tr>
<td style="text-align: left;">gender</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">性别(1:男 2:女 3:未知）</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">电话信息</td>
</tr>
<tr>
<td style="text-align: left;">phoneUrl</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">头像图片链接</td>
</tr>
<tr>
<td style="text-align: left;">userToken</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户token</td>
</tr>
<tr>
<td style="text-align: left;">userAuth</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">个人认证信息</td>
</tr>
<tr>
<td style="text-align: left;">enterAuth</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">企业认证信息</td>
</tr>
</tbody>
</table>
<h5>2.2. 客户端模式相关接口</h5>
<h6>简要描述：</h6>
<p>采用 Oauth2.0 的客户端模式获取 access_token【推送消息必须使用这个access_token，不要与前面的access_token混淆】</p>
<h6>请求测试环境地址 URL：</h6>
<p><code>https://auths-test.dysmt.cn/oauth/token</code></p>
<p>#######请求方式：</p>
<ul>
<li>POST
<h6>请求参数</h6></li>
</ul>
<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;">grant_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>填写client_secret</td>
</tr>
<tr>
<td style="text-align: left;">scope</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>填写client_baseinfo</td>
</tr>
<tr>
<td style="text-align: left;">client_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">client_secret</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方密钥</td>
</tr>
</tbody>
</table>
<h6>请求示例</h6>
<pre><code>https://auths-test.dysmt.cn/oauth/token?client_id=057ffa40*******f9b9bac69dc4c8d&client_secret=2faa6ccb0ca*********a8c7aa31c5c&grant_type=client_credentials&scope=client_baseinfo</code></pre>
<h6>返回参数：</h6>
<pre><code>{
"access_token": "ACCESS_TOKEN",
"token_type": "bearer",
"expires_in": 604799,
"scope": "client_baseinfo",
"jti": "24f10f91-49b0-46e9-95fc-e07e12b89895"
}</code></pre>
<h6>返参说明：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">access_token</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">接口调用凭证</td>
</tr>
<tr>
<td style="text-align: left;">token_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">接口调用凭证类型</td>
</tr>
<tr>
<td style="text-align: left;">expires_in</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">access_token 接口调用凭证超时时间，单位（秒）</td>
</tr>
<tr>
<td style="text-align: left;">scope</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户授权的作用域，使用逗号（,）分隔</td>
</tr>
</tbody>
</table>
<h6>特别提醒：</h6>
<ul>
<li><code>客户端模式获取的 access_token 只能调用客户端特有的功能（如推送消息功能）</code></li>
</ul>
<h5>2.2.2 推送消息</h5>
<p>#######简要描述：
通过app进行第三方推送消息</p>
<p>#######请求测试环境地址 URL：</p>
<ul>
<li><code>https://authr-test.dysmt.cn/resource/client/message/push/v2</code></li>
</ul>
<h6>请求方式：</h6>
<ul>
<li>POST
<h6>请求参数</h6></li>
</ul>
<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;">access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户端凭证</td>
</tr>
</tbody>
</table>
<h6>请求示例</h6>
<ul>
<li><code>https://authr-test.dysmt.cn/resource/client/message/push/v2?access_token=ACCESS_TOKEN</code></li>
</ul>
<h6>Body参数：</h6>
<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;">touser</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>市民云接收用户标识，多个可用逗号隔开</td>
</tr>
<tr>
<td style="text-align: left;">templateId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>模板标识</td>
</tr>
<tr>
<td style="text-align: left;">url</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>跳转url</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>应用标识，固定值：89cf776f9d1b4c7fb41094d36792febe</td>
</tr>
<tr>
<td style="text-align: left;">siteAreaCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>推送站点区域编码，固定值：510600</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>内容数据，根据消息模版传对应模版参数的json串，例如：{"applyName":"房屋租赁证明","authTime":"15天"}</td>
</tr>
</tbody>
</table>
<pre><code>{
"touser": "8d70983260ae4a*****144b457d1d29",
"templateId": "131a737039f*****17aa3283b3bf8",
"url": "https://www.baidu.com",
"appId": "89cf776f9d1b4c7fb41094d36792febe",
"data": "{\"content\":\"【缴费成功】第一小学吴张三缴费成功。\"}",
"siteAreaCode":"510600"
}</code></pre>
<h6>消息模版示例：</h6>
<pre><code>您的{applyName}申请已批准，请在{authTime}内前往自助签注机上打印签注，逾期未打印签注，申请将自动关闭！</code></pre>
<h6>返回示例</h6>
<pre><code>{
"status": 1,
"code": 0,
"content": true,
"message": null
}</code></pre>
<h6>返参说明：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">状态信息</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">接口调用凭证类型</td>
</tr>
<tr>
<td style="text-align: left;">content</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">内容状态</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">消息内容</td>
</tr>
</tbody>
</table>
<h6>2.2.2 获取用户绑定的第三方信息（微信小程序）</h6>
<h6>简要描述：</h6>
<p>获取用户绑定的第三方信息（微信小程序）</p>
<h6>请求测试环境地址 URL</h6>
<ul>
<li><code>https://authr-test.dysmt.cn/resource/user/third-info?access_token=客户端模式授权 token</code></li>
</ul>
<h6>请求方式：</h6>
<ul>
<li>POST</li>
</ul>
<h6>请求参数:</h6>
<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;">access_token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户端凭证</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>应用标识，固定值：89cf776f9d1b4c7fb41094d36792febe</td>
</tr>
<tr>
<td style="text-align: left;">userId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>用户id号</td>
</tr>
<tr>
<td style="text-align: left;">thirdType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方类型，微信小程序：4</td>
</tr>
<tr>
<td style="text-align: left;">clientId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>第三方唯一标识</td>
</tr>
</tbody>
</table>
<h6>入参示例:</h6>
<ul>
<li><code>https://authr-test.dysmt.cn/resource/user/third-info?access_token=ACCESS_TOKEN</code></li>
</ul>
<h6>body请求示例:</h6>
<pre><code>{
"userId": "8d70983260ae4a*****144b457d1d29",
"thirdType": 4,
"clientId": "057ffa40*******f9b9bac69dc4c8d",
"appId": "89cf776f9d1b4c7fb41094d36792febe"
}</code></pre>
<h6>返回示例:</h6>
<pre><code>{
"status": 1,
"code": 0,
"content": {
"thirdType": 4,
"thirdName": null,
"bindUserId": "b2cfbd4d6876468294c1fb1d20ebd7b0",
"openId": "osqrU5ITeF-VgEP1DbLW6Cbh0GXE"
},
"message": null
}</code></pre>
<h6>返参说明：</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">请求状态（0：失败；1：成功）</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">错误码 （0：无异常）</td>
</tr>
<tr>
<td style="text-align: left;">thirdName</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">绑定的第三方昵称</td>
</tr>
<tr>
<td style="text-align: left;">thirdType</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">绑定的第三方类型</td>
</tr>
<tr>
<td style="text-align: left;">content</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">详情信息</td>
</tr>
<tr>
<td style="text-align: left;">bindUserId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">绑定的用户标识</td>
</tr>
<tr>
<td style="text-align: left;">openId</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">第三方标识（这边是微信小程序的 openId）</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">消息内容</td>
</tr>
</tbody>
</table>