资讯任务接口
<h3><strong>用户任务数据获取接口</strong></h3>
<p><strong>域名</strong>
测试环境:<a href="https://testcommunity.sparta.html5.qq.com">https://testcommunity.sparta.html5.qq.com</a>
正式环境:<a href="https://communityapi.xw.qq.com">https://communityapi.xw.qq.com</a></p>
<p><strong>接口地址</strong>:/platform/v1/user/task/get_info
<strong>请求方式:</strong>POST
<strong>内容类型:</strong>application/json</p>
<p><strong>参数</strong></p>
<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>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">app_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">平台id</td>
</tr>
<tr>
<td style="text-align: left;">qudao</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">渠道名</td>
</tr>
<tr>
<td style="text-align: left;">qduid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">渠道用户id</td>
</tr>
<tr>
<td style="text-align: left;">task_ids</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">任务名(多个用,分隔)</td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">请求时间戳(秒级)</td>
</tr>
<tr>
<td style="text-align: left;">request_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">请求id(每次请求唯一id)</td>
</tr>
<tr>
<td style="text-align: left;">sig</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">签名(见后文签名计算方法)</td>
</tr>
</tbody>
</table>
<p>task_ids目前支持值:"yuedu" (用户阅读任务)</p>
<p><strong>返回值</strong></p>
<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>
<th style="text-align: left;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">0</td>
<td style="text-align: left;">错误码,0为成功</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object[]</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">返回数据</td>
</tr>
<tr>
<td style="text-align: left;">task_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">任务名</td>
</tr>
<tr>
<td style="text-align: left;">task_rate</td>
<td style="text-align: left;">number</td>
<td style="text-align: left;"></td>
<td style="text-align: left;"></td>
<td style="text-align: left;">完成数量(yuedu任务,返回的是用户阅读完成篇数)</td>
</tr>
</tbody>
</table>
<p><strong>签名计算方法</strong></p>
<ul>
<li>
<p>app_id 和 app_key由服务方提供,task_id 由服务方提供</p>
</li>
<li>sig签名方式: 将参数名除sig外按字典升序排序,再按key=value格式用&拼接,再拼接上app_key,计算字符串的SHA256值
<pre><code class="language-json">例: 若平台方的账号信息为:app_id=1, app_key=11111111 参数如下:
app_id=1
qudao=qudao1
qduid=123456
task_ids=yuedu
timestamp=1614308245
request_id=abc2222</code></pre></li>
</ul>
<p><strong>签名计算步骤</strong></p>
<ul>
<li>step1: 将参数名按字典升序排序,参数再按此顺序用&拼接,得到如下字符串
<pre><code class="language-json">app_id=1&qduid=123456&qudao=qudao1&request_id=abc2222&task_ids=yuedu&timestamp=1614308245</code></pre></li>
<li>step2: 将分配的app_key拼接到字符串最后,得到如下字符串
<pre><code class="language-json">app_id=1&qduid=123456&qudao=qudao1&request_id=abc2222&task_ids=yuedu&timestamp=161430824511111111</code></pre></li>
<li>step3: 计算字符串SHA256,得到sig值
<pre><code class="language-json"> e82ceaca20e4721b0b88c43180976678216c6088cb139ef396812719362e3418</code></pre></li>
</ul>
<h3>珊瑚公有任务</h3>
<p><strong>参数</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">task_type</th>
<th style="text-align: left;">任务类型</th>
<th style="text-align: left;">type_id</th>
<th style="text-align: left;">样式描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">60</td>
<td style="text-align: left;">资讯任务</td>
<td style="text-align: left;">236</td>
<td style="text-align: left;">资讯样式--珊瑚公有</td>
</tr>
</tbody>
</table>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/27557ff49df453d682c6679d06c4cc19" alt="" /></p>