# 说明

查询企业的授权(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

# 响应字段说明

字段 类型 说明
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)

当前接口只返回研发协作产品的授权数据,不包含轻协作授权。

上次更新: 2026-11-12 10:06:45