积分发放¶
功能说明¶
企业(或集团,需传enterprise_code)给企业员工发放关爱积分(积分从企业的积分账户扣取)
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/assets/jifen/enterprise/assign/single
- 生产环境: https://openapi.guanaitong.com/assets/jifen/enterprise/assign/single
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| userid | 是 | string | [1,100] | 员工第三方唯一标识,不会变更 |
| thirdType | 否 | int | [1,5] | 1:企业微信, 2:钉钉,3:飞书,4, 定制, 5:标准对接,非必填默认5 |
| account_openid | 否 | string | [32] | 积分账户的openid,决定扣哪个积分账户的积分 |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团必填,企业无需填写) |
| amount | 是 | decimal(10,2) | [0.01,99999999.99] | 发放积分金额 |
| reason | 是 | string | [1,254] | 发放原因 |
| external_code | 是 | string | [10,30] | 外部交易号,支持数字+字母,不支持特殊字符 |
请求示例¶
POST /assets/jifen/enterprise/assign/single HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=6007bf4c6efeb798da35b843e4614cff&amount=100&corp_code=CJJ101&&reason=test
external_code=1495094685222&sign=dc2cb643d101d8ae96e857ff4ca24de23bf4f27f&
timestamp=1495094685
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |