操作账户余额V2
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>批量操作用户账户金币数或 VIP 天数</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/member/operate/coin-vipV2</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;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>应用 ID</td>
</tr>
<tr>
<td style="text-align: left;">openIds</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<String></td>
<td>隶属于 <code>appId</code> 的用户 openid 列表，列表大小限制：[1, 100]，即列表最多添加100个用户 openid，注意：这些用户必须属于指定的 <code>appId</code> 应用</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-vipV2' \
--header 'Auth-Id: 16190087260012544' \
--header 'Authorization: 2Zibib8vgS6PdBfm' \
--header 'Content-Type: application/json' \
--data '{
&quot;appId&quot;: 19743565588729856,
&quot;openIds&quot;: [
&quot;oTvie6aBgvMJLhTj_KxX-SmHrz10&quot;,
&quot;oTvie6aJzwEFjL3ABGzIUSnaJ82w&quot;,
&quot;oTvie6fHddBq1Fu7YmG5nUiilrJ8&quot;,
&quot;oTvie6TUIXsvR8WOmf5yE8PTpQik&quot;
],
&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;failOpenIds&quot;: [],
&quot;successOpenIds&quot;: [
&quot;oTvie6aBgvMJLhTj_KyS-SmHrz10&quot;,
&quot;oTvie6aJzwEFjL3ABGziUSnaJ82w&quot;,
&quot;oTvie6fHddBq1Fu3YmG5nUiilrJ8&quot;,
&quot;oTvie6TUIXsvR8WOmf2yE8PTpQik&quot;
]
},
&quot;msg&quot;: &quot;OK&quot;,
&quot;traceId&quot;: &quot;b357b31d-1764-409f-892a-261df5cf0bfa&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;">successOpenIds </td>
<td style="text-align: left;">List<String> </td>
<td>操作成功的用户 openid 列表 </td>
</tr>
<tr>
<td style="text-align: left;">failOpenIds </td>
<td style="text-align: left;">List<String> </td>
<td>操作失败的用户 openid 列表 </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>