商战网络前台API开发文档

商战网络


卡密生成api接口

<p><strong>简要描述:</strong> </p> <ul> <li> <p>卡密生成api接口</p> <p>1、POST请求,Content-Type必须设置为:application/json; 2、card_group_id(卡组id)可登陆平台访问 <a href="https://www.qqkami.com/userCenter/card_group">https://www.qqkami.com/userCenter/card_group</a> 获取已经添加的卡组id 3、参与签名的参数:customerid,card_group_id,quantity,card_type,expires_date 4、expires_date 时间为24小时制标准时间字符串格式</p> </li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://平台域名/api.php/Client/hamiltonianGeneration</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> <th>示例值</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">customerid</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>用户编号</td> <td>1234</td> </tr> <tr> <td style="text-align: left;">card_group_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>卡组id</td> <td>12345</td> </tr> <tr> <td style="text-align: left;">quantity</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>生成数量</td> <td>1</td> </tr> <tr> <td style="text-align: left;">card_type</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>卡组返回类型,1卡密 2链接直充</td> <td>card_type=1返回卡密:G1BWfRwT3ByErHOxxxx;card_type=2返回卡密链接:<a href="http://www.99kami.com/Carmi=G1BWfRwT3ByErHOxxxx">http://www.99kami.com/Carmi=G1BWfRwT3ByErHOxxxx</a></td> </tr> <tr> <td style="text-align: left;">expires_date</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>卡密过期时间(YYYY-mm-dd HH:ii:ss),为空时卡密永久有效</td> <td>2023-07-29 23:59:59</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>进货接口访问密钥</td> <td>d6df0b5aadf33d111102b617b4ab4da5</td> </tr> </tbody> </table> <p><strong>返回格式:</strong></p> <ul> <li>json </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;">code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">1000</td> <td>请求结果,结果码</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">是</td> <td style="text-align: left;">[&quot;LvD755HQQludXxXgvcbM&quot;,&quot;LfM21TTUEE8dOXOfgUbD&quot;]</td> <td>卡密列表</td> </tr> <tr> <td style="text-align: left;">info</td> <td style="text-align: left;">是</td> <td style="text-align: left;">结果描述语</td> <td>卡密获取成功</td> </tr> </tbody> </table> <p><strong>返回示例-成功案例:</strong></p> <pre><code>//card_type=1返回示例 { &amp;quot;code&amp;quot;: 1000, &amp;quot;data&amp;quot;: [ &amp;quot;http://www.99kami.com/Carmi=GBPDEfEOIWMsBOBhUbc6&amp;quot;, &amp;quot;http://www.99kami.com/Carmi=AJKV99MIPTbZBMZBh7b4&amp;quot; ], &amp;quot;info&amp;quot;: &amp;quot;卡密获取成功&amp;quot; } //card_type=2返回示例 { &amp;quot;code&amp;quot;: 1000, &amp;quot;data&amp;quot;: [ &amp;quot;LvD755HQQludXxXgvcbM&amp;quot;, &amp;quot;LfM21TTUEE8dOXOfgUbD&amp;quot; ], &amp;quot;info&amp;quot;: &amp;quot;卡密获取成功&amp;quot; }</code></pre> <p><strong>返回示例-失败案例:</strong></p> <pre><code>{ &amp;quot;code&amp;quot;: 1001, &amp;quot;info&amp;quot;: &amp;quot;原因: 请求参数不合法.&amp;quot; }</code></pre> <p><strong>错误码:</strong> </p> <table> <thead> <tr> <th>错误码</th> <th>错误解释</th> </tr> </thead> <tbody> <tr> <td>1000</td> <td>卡密生成成功</td> </tr> <tr> <td>1010</td> <td>卡密生成失败</td> </tr> <tr> <td>其他</td> <td>参考全局错误码</td> </tr> </tbody> </table> <p><strong>备注:</strong> </p> <ul> <li>code为1000代表成功,其他为失败</li> <li>更多返回错误代码请看首页的全局错误代码描述</li> </ul>

页面列表

ITEM_HTML