自定义奖品发奖接口(未发布)
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>自定义奖品发奖接口,由自定义奖品接入方提供该接口。</li>
<li>当用户兑换自定义奖品的时候,珊瑚通过该接口向自定义奖品接入方兑换该奖品</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>接入方在库存资源从商品入库中分配库存到分配商品的时候填入的发奖地址
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=0bc61a33b71fe4ef86c22ec89b671719&amp;file=file.png" alt="" /></li>
<li>不能携带后缀参数</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>签名方式</h5>
<p>参考:<a href="https://www.showdoc.com.cn/1procedure2develop/4613304376289731">https://www.showdoc.com.cn/1procedure2develop/4613304376289731</a></p>
<h5>参数</h5>
<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;">account_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string[1,64]</td>
<td>兑奖的用户ID</td>
</tr>
<tr>
<td style="text-align: left;">goods_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string[1,64]</td>
<td>商品ID,接入方在库存资源从商品入库中分配库存到分配商品的时候填入的商品ID</td>
</tr>
<tr>
<td style="text-align: left;">award_params</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string[1,1000]</td>
<td>发奖参数,接入方在库存资源从商品入库中分配库存到分配商品的时候填入的发奖参数</td>
</tr>
<tr>
<td style="text-align: left;">cid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>在库存资源从商品入库中分配库存到分配商品生成的素材ID</td>
</tr>
<tr>
<td style="text-align: left;">order_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string[1,200]</td>
<td>发奖订单号,每次兑换的发奖订单号都是唯一的</td>
</tr>
<tr>
<td style="text-align: left;">exc_detail</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string[1,200]</td>
<td>透传通过接口兑换商品的时候传的exc_detail</td>
</tr>
<tr>
<td style="text-align: left;">ext</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string[1, 1000]</td>
<td>扩展参数,透传通过接口兑换商品的时候传的ext</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>// 发奖成功
{
&quot;ret&quot;: 0,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: {
&quot;award_result_url&quot;: &quot;xxxx&quot;
}
}
// 发奖失败
{
&quot;ret&quot;: -1,
&quot;msg&quot;: &quot;fail msg&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;">ret</td>
<td style="text-align: left;">int</td>
<td>状态码,ret为0则是发奖成功,非0为发奖失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">int</td>
<td>失败的时候,请填写失败原因</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">object</td>
<td>发奖成功的数据</td>
</tr>
<tr>
<td style="text-align: left;">data.award_result_url</td>
<td style="text-align: left;">string</td>
<td>兑奖结果地址,如果没有兑奖结果地址,请填写空字符串</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<p>该接口在遇到网络错误后会返回兑换失败,如果是商城兑换会返还相应的积分。</p>