第三方奖品操作库存接口

为了您能成功使用第三方奖品库存功能，您需要按照以下约定来提供接口：

接口数据安全：在和24好玩平台对接接口时，需要先了解【开放接口签名】。

1. 预占奖品库存接口

24好玩会在活动发布时，调用这个接口来占用您配置的奖品的库存。

请求方式：POST 请求

请求参数说明（Request Body）

请求头：Content-Type: application/json

返回参数说明 Response Body

返回头：Content-Type: application/json

返回错误码说明 Error Code

接口详细说明

/**
 * @apiDescription    预占奖品库存
 * @api               {POST}
 * @apiVersion        1.0.0
 * @apiHeader         (Reqeust Headers) Contnet-Type application/json
 *
 * @params            {int}         gift_list          必选，预占奖品库存列表。示例：[{"gift_id":"17","gift_type":"COUPON","num":"50"}]，其中，gift_id 是第三方奖品id，gift_type 是第三方奖品类型，num 是预占第三方奖品数量
 * @params            {str}         sign               必选，签名
 * @params            {str}         game_id            可选，活动id
 * @params            {str}         game_name          可选，活动名称
 *
 * @apiSuccess        {int}         code               返回码
 * @apiSuccess        {str}         msg                错误描述
 * @apiSuccess        {str}         result             返回结构
 *
 * @apiSuccessExample {json}        Success-Response:
 *    {
 *        code : 0,
 *        msg : "ok",
 *        result: {}
 *    }
 * @apiErrorExample   {json}        error_code: 7100
 *    {
 *        code : 7100,
 *        msg : "token error"       // token错误
 *        result: ""
 *    }
 * @apiErrorExample   {json}        error_code: 9007
 *    {
 *        code : 9007,
 *        msg : "gift num err",     // 预占奖品失败
 *        result: ""
 *    }
 */

2.释放奖品库存接口

24好玩会在活动结束时，调用这个接口来释放占用的奖品库存。

请求类型：POST

请求参数说明（Request Body）

请求头：Content-Type: application/json

返回参数说明（Response Body）

Content-Type: application/json

返回错误码说明（Error Code）

接口详细说明

/**
 * @apiDescription    释放奖品库存
 * @api               {POST}
 * @apiVersion        1.0.0
 * @apiHeader         (Reqeust Headers) Contnet-Type application/json
 * @params            {int}         gift_list          必选，释放奖品库存列表。示例：[{"gift_id":"17","gift_type":"COUPON","num":"50"}]，其中，gift_id 是第三方奖品id，gift_type 是第三方奖品类型，num 是预占第三方奖品数量
 * @params            {str}         sign               必选，签名
 * @params            {str}         game_id            可选，活动id
 * @params            {str}         game_name          可选，活动名称
 *
 * @apiSuccess        {int}         code               返回码
 * @apiSuccess        {str}         msg                错误描述
 * @apiSuccess        {str}         result             返回结构
 *
 * @apiSuccessExample {json}        Success-Response:
 *    {
 *        code : 0,
 *        msg : "ok",
 *        result: {}
 *    }
 * @apiErrorExample   {json}        error_code: 7100
 *    {
 *        code : 7100,
 *        msg : "token error"       // token错误
 *        result: ""
 *    }
 * @apiErrorExample   {json}        error_code: 9008
 *    {
 *        code : 9008,
 *        msg : "gift num err",     // 释放奖品失败
 *        result: ""
 *    }
 */