领取奖励
<p><strong>简要描述：</strong></p>
<ul>
<li>领取指定奖励</li>
</ul>
<p><strong>请求URL：</strong></p>
<ul>
<li><code>/api/v1/third-exchange/take-award</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<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>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">appid</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">string</td>
<td>应用APPID</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">string</td>
<td>用户TOKEN</td>
</tr>
<tr>
<td style="text-align: left;">ex_id</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">string</td>
<td>记录ID</td>
</tr>
<tr>
<td style="text-align: left;">ex_item_id</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">int</td>
<td>商品ID</td>
</tr>
<tr>
<td style="text-align: left;">ex_item_name</td>
<td style="text-align: left;">必选</td>
<td style="text-align: left;">string</td>
<td>商品名称</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code># 成功
{
&quot;code&quot;: 0,
&quot;message&quot;: &quot;ok&quot;,
&quot;data&quot;: {
&quot;id&quot;: 3,
&quot;status&quot;: 6
}
}
# 异常
{
&quot;code&quot;: 422,
&quot;message&quot;:&quot;请完成实名后操作&quot;,
&quot;data&quot;: null
}</code></pre>
<p><strong>返回参数说明</strong></p>
<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.id</td>
<td style="text-align: left;">string</td>
<td>我方领取记录ID</td>
</tr>
<tr>
<td style="text-align: left;">data.status</td>
<td style="text-align: left;">string</td>
<td>状态值, 4 失败, 5 处理中, 6 处理完成</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong></p>
<pre><code>接口有IP白名单限制.
接口使用ExId去重, 支持同ExId多次请求, 若存在记录, 则直接返回数据.
若返回`处理中`, 需要稍候再次请求接口, 获取结果.
</code></pre>