跳转至

指定活动发放资产

功能说明

管理员在关爱通平台建立的活动，指定本次需要给哪些员工来发放哪种类型的资产，需要指出本次给员工发放的资产数量或金额，具体参见下面字段。

接口地址

HTTP请求方式

  • Method: POST
  • Content-Type: application/x-www-form-urlencoded

参数说明

  • 公有参数

    发送请求是必须传入公共参数，详见公共参数

  • 私有参数

参数名称 是否必须 参数类型 长度限制 描述
activity_id 是 int 活动id
external_code 是 string [10,40] 外部交易号，支持数字+字母，不支持特殊字符
user_ids 是 string [1,1000] 用户唯一标识，多个用英文逗号隔开，最大限制50人
mode 是 string enum 支持3种发放模式：birthday（按生日）；entryDay（按入职）；immediate（立即发放）
amount 是 decimal(10,2) [0.01,99999999.99] 发放金额或发放数量；当asset_type为[point,quota]时，请填金额字段；asset_type为[coupon]时，请填整数，代表兑换券张数
reason 否 string [1,50] 发放原因
account_openid 否 string [1,50] 指定的活动中asset_type为[point,coupon]时，需要指定此字段

请求示例

https://openapi.guanaitong.tech/enterprise/activity/assign?
activity_id=1929&external_code=202216987203498&user_ids=eddie,mask&mode=immediate&reason=测试发放生日福利&account_openid=14328&access_token=d344dff48ad98ee5fe855f327f734e81
&sign=82684dc40291cdef87e91148586f00f730ce7815&timestamp=1646727532&amount=2

返回参数说明

参数名称 描述
code 返回码。详见错误返回码。
msg 如果错误，返回错误信息。
data 如果没有错误，返回请求时"外部发放号"

正确返回示例

说明：code为0代表请求成功，但是发放不一定成功，请业务人员到企业端活动管理中观察发放结果，具体以结果页面为准； 如果发放过程中有失败的员工，会以邮件形式通知管理员，请管理员关注！

{
    "code": 0,
    "data": "202216987203498",
    "msg": "OK"
}

错误返回示例

{
    "code": 1000210004,
    "data": null,
    "msg": "tokeninfo check failed!"
}
回到页面顶部