# 说明
查询企业的授权(license)信息,包含版本、授权有效期、授权类型、席位使用情况等。
接口以企业 ID(company_id)为维度返回数据。
使用场景:
- 企业管理员集成第三方运维平台时,自动化查看当前订阅版本、剩余授权、到期时间
- 告警巡检:到期前提醒续费、授权用满提醒清理
# url
https://api.tapd.cn/companies/get_license_info
# 支持格式
JSON(默认 JSON 格式)
# HTTP 请求方式
GET
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| company_id | 是 | integer | 企业 ID |
# 调用示例及返回结果
# 查询企业 10104801 的授权信息
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/companies/get_license_info?company_id=10104801'
# 返回结果
{
"status": 1,
"data": {
"company_id": 10104801,
"total_license_count": 500,
"used_license_count": 342,
"expire_time": "2027-01-01 00:00:00",
"license_status": "valid",
"license_edition": "enterprise",
"license_type": "formal"
},
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| company_id | integer | 企业 ID,与请求参数一致 |
| total_license_count | integer | 企业购买的研发协作授权总数 |
| used_license_count | integer | 已使用授权数(已授权成员数) |
| expire_time | string | 授权到期时间,格式 YYYY-MM-DD HH:mm:ss;若授权无到期时间返回空串 |
| license_status | string | 授权状态:valid 有效、expiring 即将到期(距到期 ≤ 30 天)、expired 已过期 |
| license_edition | string | 版本标识,枚举值见下方「版本枚举」 |
| license_type | string | 授权类型:formal 正式、trial 试用 |
# 版本枚举
| license_edition 字段值 | 说明 |
|---|---|
| professional | 专业版(Lite) |
| premium | 卓越版(Premium) |
| enterprise | 企业版(Pro) |
当前接口只返回研发协作产品的授权数据,不包含轻协作授权。