额度设置

额度设置

1. 设置用户的流量额度月查上限

请求路径

• https://{host}/api_skb/v1/isv/user/update_quota_limit

测试环境：https://skb-test.weiwenjia.com
生产环境：https://skb.weiwenjia.com

请求方法

• put

headers

请求参数:

body参数，JSON示例

{
    "oid": 10010036, // 必填，Long类型，skb企业id
    "uids": [9146042], // 必填，List<Long>类型，要设置的skb用户uid
    "sign": "xxxx", // 必填，签名，签名算法：sign=md5(oid+secret)
    "quota": 100, // 选填，Integer类型，要设置的额度上限，为null时表示不设置额度上限；非null时必须 >=0 且 < 2000000
}

返回格式:

{
    "error_code": 0,
    "message": "",
    "success": true,
    "data": null
}

2. 查询额度使用情况

请求路径

• https://{host}/api_skb/v1/isv/user/get_quota_usage

测试环境：https://skb-test.weiwenjia.com
生产环境：https://skb.weiwenjia.com

请求方法

• post

headers

请求参数:

body参数，JSON示例

{
    "sign": "xxxx",  // 必填，签名，签名算法：sign=md5(oid+secret)
    "oid": 10010036, // 必填，Long类型，skb企业id
    "uids": [9146042, 9146043] // 选填，List<Long>类型，要查询的skb用户uid，为null或空数组时，只返回企业的额度情况
}

返回格式:

{
    "error_code": 0,
    "message": "",
    "success": true,
    "data": {
        "orgQuotaExpireDate": "2027-04-23T23:59:59.000+08:00",  // 企业流量额度过期时间
        "orgExpired": false,  // 企业流量额度是否已过期
        "orgQuota": 200000,  // 企业的总额度
        "orgUsedQuota": 1,  // 企业总的已使用额度
        "orgQuotaMonthly": null,  // 企业的月额度上限（null表示未设置）
        "orgThisMonthUsedQuota": 1,  // 企业当月已使用额度
        "orgRemainQuota": 199999,  // 企业总的剩余额度
        "orgThisMonthRemainQuota": 199999,  // 企业当月剩余额度
        "usersQuotaUsage": [  // 用户的额度使用情况
            {
                "uid": 9146042,
                "userUsedQuota": 1,  // 用户总的已使用额度
                "userQuotaLimitation": 2,  // 设置的用户额度月上限（null表示未设置）
                "userThisMonthUsedQuota": 1,  // 用户当月已使用额度
                "userRemainQuota": 1  // 用户当月剩余额度
            }
        ]
    }
}