操作账户余额
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>批量操作用户账户金币数或 VIP 天数</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/member/operate/coin-vip</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
</ul>
<h5>参数</h5>
<p><strong>【参数】 =【通用参数】+ 【商品类型关联参数】</strong></p>
<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;">memberIds</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<Long></td>
<td>用户 ID 列表,列表大小限制:[1, 100],即列表最多添加100个用户 ID</td>
</tr>
<tr>
<td style="text-align: left;">operateType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>操作行为:<br/>1-增加;<br/>2-减少</td>
</tr>
<tr>
<td style="text-align: left;">productType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>商品类型:<br/>1-金币;<br/>2-VIP</td>
</tr>
</tbody>
</table>
<h6>商品类型关联参数</h6>
<ul>
<li>商品类型设置为 1-金币 时,需设置的参数:</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;">coins</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>金币数,<strong>正整数</strong></td>
</tr>
<tr>
<td style="text-align: left;">days</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>有效期天数,<strong>正整数</strong>,<strong>当操作行为是 1-增加时,为必填!</strong></td>
</tr>
</tbody>
</table>
<ul>
<li>商品类型设置为 2-VIP 时,需设置的参数:</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;">days</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>VIP 天数,<strong>正整数</strong></td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<h6>增加账户金币数</h6>
<pre><code class="language-cURL">curl --location 'https://gateway-partner.nm-serv.cn/member/operate/coin-vip'
--header 'Auth-Id: 1619008726xx12544'
--header 'Authorization: 2Zibib8vgxxPdBfm'
--header 'Content-Type: application/json'
--data '{
&quot;memberIds&quot;: [
187457xx660827136,
21336998xx7676672,
219xx519253913600,
225713321405358xx
],
&quot;operateType&quot;: 1,
&quot;productType&quot;: 1,
&quot;coins&quot;: 10,
&quot;days&quot;: 30
}'</code></pre>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;:0,
&quot;data&quot;:{
&quot;failMemberIds&quot;:[
],
&quot;successMemberIds&quot;:[
18745730660827136,
21336968987676672,
21954519253913600,
22571332140535808
]
},
&quot;msg&quot;:&quot;OK&quot;,
&quot;traceId&quot;:&quot;732404e2-44a3-4048-9da3-a333b54a5078&quot;
}</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;">Integer </td>
<td>返回码 </td>
</tr>
<tr>
<td style="text-align: left;">msg </td>
<td style="text-align: left;">String </td>
<td>返回消息 </td>
</tr>
<tr>
<td style="text-align: left;">traceId </td>
<td style="text-align: left;">String </td>
<td>链路追踪 ID </td>
</tr>
<tr>
<td style="text-align: left;">data </td>
<td style="text-align: left;">Object </td>
<td>操作账户余额响应 </td>
</tr>
</tbody>
</table>
<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;">successMemberIds </td>
<td style="text-align: left;">List<Long> </td>
<td>操作成功的用户 ID 列表 </td>
</tr>
<tr>
<td style="text-align: left;">failMemberIds </td>
<td style="text-align: left;">List<Long> </td>
<td>操作失败的用户 ID 列表 </td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>返回错误代码请查看[错误响应](<a href="https://www.showdoc.com.cn/gatewaypartnerv1/10903560257841502">https://www.showdoc.com.cn/gatewaypartnerv1/10903560257841502</a> "错误响应")页面描述</li>
</ul>