4.1 - 打卡排名
<p>[TOC]</p>
<h5>简要描述:</h5>
<ul>
<li>小程序 - 打卡排名接口(需登录)</li>
</ul>
<h5>请求URL:</h5>
<ul>
<li><code>https://xx.com/api/clockIn/rankingInfo</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </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;">satoken</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>授权码</td>
</tr>
</tbody>
</table>
<ul>
<li>说明:
<ul>
<li>未登录时,直接弹出授权登录页面</li>
</ul></li>
</ul>
<h5>请求示例</h5>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 200,
&quot;desc&quot;: &quot;成功&quot;,
&quot;data&quot;: {
&quot;userId&quot;: 1,
&quot;userName&quot;: &quot;大师兄-时光&quot;,
&quot;userImgUrl&quot;: &quot;https://example.com/article1.jpg&quot;,
&quot;ranking&quot;: 2,
&quot;myClockInDay&quot;: 100,
&quot;clockInList&quot;: [{
&quot;userId&quot;: 1,
&quot;userName&quot;: &quot;大师兄-时光&quot;,
&quot;userImgUrl&quot;: &quot;https://example.com/article1.jpg&quot;,
&quot;ranking&quot;: 2,
&quot;clockInDay&quot;: 100
}, {
&quot;userId&quot;: 1,
&quot;userName&quot;: &quot;周乐心&quot;,
&quot;userImgUrl&quot;: &quot;https://example.com/article1.jpg&quot;,
&quot;ranking&quot;: 2,
&quot;clockInDay&quot;: 90
}]
}
}</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;">data</td>
<td style="text-align: left;">Object</td>
<td>数据主体</td>
</tr>
<tr>
<td style="text-align: left;">data.userId</td>
<td style="text-align: left;">Int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.userName</td>
<td style="text-align: left;">String</td>
<td>当前用户名</td>
</tr>
<tr>
<td style="text-align: left;">data.userImgUrl</td>
<td style="text-align: left;">String</td>
<td>当前用户头像</td>
</tr>
<tr>
<td style="text-align: left;">data.ranking</td>
<td style="text-align: left;">int</td>
<td>当前用户排名</td>
</tr>
<tr>
<td style="text-align: left;">data.myClockInDay</td>
<td style="text-align: left;">int</td>
<td>当前签到的的天数</td>
</tr>
<tr>
<td style="text-align: left;">---------------</td>
</tr>
<tr>
<td style="text-align: left;">data.clockInList</td>
<td style="text-align: left;">Array</td>
<td>邀请列表</td>
</tr>
<tr>
<td style="text-align: left;">data.userId</td>
<td style="text-align: left;">Int</td>
<td>用户ID</td>
</tr>
<tr>
<td style="text-align: left;">data.clockInList.userName</td>
<td style="text-align: left;">String</td>
<td>用户名</td>
</tr>
<tr>
<td style="text-align: left;">data.clockInList.userImgUrl</td>
<td style="text-align: left;">String</td>
<td>用户头像</td>
</tr>
<tr>
<td style="text-align: left;">data.ranking</td>
<td style="text-align: left;">int</td>
<td>用户排名</td>
</tr>
<tr>
<td style="text-align: left;">data.clockInList.clockInDay</td>
<td style="text-align: left;">int</td>
<td>签到天数</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>实际开发接口时,可稍微调整</li>
</ul>