额度发放¶
功能说明¶
企业(或集团)额度单个发放
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/assets/limit/enterprise/assign/single
- 生产环境: https://openapi.guanaitong.com/assets/limit/enterprise/assign/single
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] | 企业额度唯一标识,后台添加额度之后,线下把limit的openid给企业。 |
| sub_limit_id | 否 | int | 额度子账户id,联系开发人员提供 | |
| enterprise_code | 否 | string | [1,20] | 企业编号(集团和运营商必填,单企业模式不填) |
| assignerOpenId | 否 | string | [1,100] | 发放人openId |
| amount | 是 | decimal(10,2) | [0.01,99999999.99] | 额度的数额 |
| remark | 否 | string | [0,100] | 发放原因 |
| external_code | 是 | string | [10,30] | 外部发放交易号,支持数字+字母,不支持特殊字符 |
| expire_time | 否 | string | [8-14] | 额度过期时间,格式为yyyyMMdd或yyyyMMddHHmmss ,如:20230807(默认23:59:59过期),20230807000100(支持到分钟级别) |
请求示例¶
https://openapi.guanaitong.tech/assets/limit/enterprise/assign/single?
access_token=07c39179de148f8d92f96ac6a67d96c3&amount=30&comment=开放平台测试&
corp_code=SN123&external_code=1494385851631&limit_openid=o0dv3Fb/IBj8ASUs8M/SEw==&
remark=额度发放&sign=71734a83358a79a127fab4fdb76fbf5f0edc9ad1&
timestamp=1494385851
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误,返回错误信息。 |
| data | 如果没有错误,返回业务数据 |