野象新媒体接口文档

新媒体对外接口文档


操作账户余额

<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&lt;Long&gt;</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>操作行为:&lt;br/&gt;1-增加;&lt;br/&gt;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>商品类型:&lt;br/&gt;1-金币;&lt;br/&gt;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 '{ &amp;quot;memberIds&amp;quot;: [ 187457xx660827136, 21336998xx7676672, 219xx519253913600, 225713321405358xx ], &amp;quot;operateType&amp;quot;: 1, &amp;quot;productType&amp;quot;: 1, &amp;quot;coins&amp;quot;: 10, &amp;quot;days&amp;quot;: 30 }'</code></pre> <h5>返回示例</h5> <pre><code>{ &amp;quot;code&amp;quot;:0, &amp;quot;data&amp;quot;:{ &amp;quot;failMemberIds&amp;quot;:[ ], &amp;quot;successMemberIds&amp;quot;:[ 18745730660827136, 21336968987676672, 21954519253913600, 22571332140535808 ] }, &amp;quot;msg&amp;quot;:&amp;quot;OK&amp;quot;, &amp;quot;traceId&amp;quot;:&amp;quot;732404e2-44a3-4048-9da3-a333b54a5078&amp;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&lt;Long&gt;    </td> <td>操作成功的用户 ID 列表              </td> </tr> <tr> <td style="text-align: left;">failMemberIds  </td> <td style="text-align: left;">List&lt;Long&gt;    </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> &quot;错误响应&quot;)页面描述</li> </ul>

页面列表

ITEM_HTML