# 发放优惠券 |拥有此API的权限集| |:----- | |营销码券管理-码券操作| **请求方式及url** - 请求方式：`POST` - 请求头：`Content-Type:application/json` - 接口地址：`https://api.xiaoe-tech.com/api/xe.user.coupon.add/1.0.0` - 频率限制：`10秒500次` {%     api      method="POST",     data={        "access_token": "xe_xxxxx", "user_id": "xx", "coupon_id": "xx"     },     url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/api/xe.user.coupon.add/1.0.0" %}  {% endapi %} **请求参数** |参数名|必选|类型|说明|备注（示例）| |:----|:---|:----- |:----- |----| |access_token |是 |string |[专属token](./../get_access_token.md) |`xxxxx`| |user_id | 是 |string | 领取用户 |`...`| |coupon_id | 是 |string / array | 需要领取的优惠券ID |`...`| ** 请求示例 ** ``` { "access_token": "xe_xxxxx", "user_id": "xx", "coupon_id": "xx" } ``` **返回参数** |参数名|必选|类型|说明|备注| |:----- |:----|:-----|:-----|---- | |code |是|int |请求结果码 |请求成功返回0，请求失败错误码请查看错误码描述说明| |msg |是|string |描述信息 |无| |data |是|class |数据 |无| 数据列表`data` |参数名|必选|类型|说明|备注（示例）| |:---- |:---|:----- |:----- |:----| |cu_id |是|string |用户优惠券ID |`xxxx`| |coupon_id |是|string |优惠券批次ID |`xxxxxx`| **返回示例** ``` { "code": 0, "msg": "领取成功", "data": [ { "cu_id": "cu_xxx", "coupon_id": "cou_x"xxx } ] } ```