额度回收¶
功能说明¶
企业(或集团,需传enterprise_code)回收所属企业员工的额度
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/assets/limit/enterprise/recycle
- 生产环境: https://openapi.guanaitong.com/assets/limit/enterprise/recycle
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| userid | 是 | string | [1,100] | 员工第三方唯一标识,不会变更 |
| corp_code | 否 | string | [1,100] | 历史对接使用该字段替代userid |
| thirdType | 否 | int | [1,5] | 1:企业微信, 2:钉钉,3:飞书,4, 定制, 5:标准对接,非必填默认5 |
| limit_openid | 是 | string | [24] | 企业额度唯一标识,即账户accoutn_open_id。 |
| sub_limit_id | 否 | int | 额度子账户id,联系开发人员提供 | |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团和运营商必填,企业不填) |
| amount | 是 | decimal(10,2) | [0.01,99999999.99] | 回收积分金额 |
| remark | 否 | string | [1,254] | 发放原因 |
| external_code | 是 | string | [10,40] | 外部回收号,支持数字+字母,不支持特殊字符 |
请求示例¶
POST /assets/limit/enterprise/recycle HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=b7822dd9becb912d540e0bbe3935be69&limit_openid=o0dv3Fbwe4r4r4r434dffdgf&amount=30&corp_code=CJJ006&external_code=1494314484245&reason=额度回收测试&
timestamp=1494314484&sign=3c4b2808af200af362f291979f35ece6a9594e50
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |