【43】取用户已领优惠券
<p>[TOC]</p>
<h5>接口状态</h5>
<ul>
<li><code>正常</code></li>
</ul>
<h5>框架版本</h5>
<ul>
<li><code>≥ 2.0.5.0</code></li>
</ul>
<h5>更新时间</h5>
<ul>
<li><code>2024/11/23</code></li>
</ul>
<h5>调用额度</h5>
<ul>
<li><code>免额度</code></li>
</ul>
<h5>简要描述</h5>
<ul>
<li>取用户已领优惠券</li>
</ul>
<h5>DLL调用例子</h5>
<pre><code>Api_GetBuyerCoupons(&quot;$userNick$&quot;,&quot;2218165087899&quot;)</code></pre>
<h5>易语言模块调用例子</h5>
<pre><code>SaiNiu.Api.取用户已领优惠券(&quot;$userNick$&quot;,&quot;2218165087899&quot;)</code></pre>
<h5>POST调用例子</h5>
<pre><code>http://127.0.0.1:3030/SaiNiuApi/Api</code></pre>
<pre><code>&amp;post=GetBuyerCoupons&amp;data={&quot;userNick&quot;:&quot;$userNick$&quot;,&quot;buyerEid&quot;:&quot;2218165087899&quot;}</code></pre>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<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;">userNick</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">千牛账号,为方便测试$userNick$表示取随机队列账号</td>
<td>tb123456</td>
</tr>
<tr>
<td style="text-align: left;">buyerEid</td>
<td style="text-align: left;">文本型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">旺旺Eid或旺旺Uid</td>
<td>2218165087899</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{&quot;code&quot;:200,&quot;data&quot;:{&quot;benefitsUrl&quot;:{&quot;memberUrl&quot;:&quot;https:\/\/tbpassport.taobao.com\/member\/benefit#\/&quot;,&quot;fansBenefitsUrl&quot;:&quot;https:\/\/qn.taobao.com\/home.htm\/private-domain-workbench\/fans&quot;,&quot;shopCouponUrl&quot;:&quot;https:\/\/qn.taobao.com\/home.htm\/coupon&quot;,&quot;miniActivityUrl&quot;:&quot;https:\/\/qn.taobao.com\/home.htm\/private-domain-workbench\/activityList?activityType=FANSPURCHASE&quot;,&quot;newCustomerUrl&quot;:&quot;https:\/\/qn.taobao.com\/home.htm\/qianniu-alimama-ppxx\/&quot;,&quot;oldCustomerUrl&quot;:&quot;https:\/\/qn.taobao.com\/home.html\/private-domain-workbench\/OldCustomer&quot;},&quot;buyerArchivesList&quot;:[]},&quot;ret&quot;:[&quot;SUCCESS::调用成功&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;">整数型</td>
<td>返回结果，成功=200，失败≠200</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">文本型</td>
<td>调用结果</td>
</tr>
<tr>
<td style="text-align: left;">reg</td>
<td style="text-align: left;">文本型</td>
<td>结果说明，调用成功或失败原因</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>