获取部门使用数据

通过 OpenAPI 获取通义灵码部门使用数据。

适用版本

企业专属版、企业标准版

服务接入点

获取服务接入点,替换 API 请求语法中的 {domain}

授权信息

产品

资源

所需权限

通义灵码

部门使用统计

只读

请求语法

GET https://{domain}/oapi/v1/lingma/organizations/{organizationId}/departmentUsage

请求说明

企业标准版

查询部门使用数据

curl -X 'GET' \
  'https://openapi-rdc.aliyuncs.com/oapi/v1/lingma/organizations/c7655445-143f-4466-9724-8b371a21****/departmentUsage?departmentId=7b58e90a-063f-475b-ad6d-32d1f438****&startTime=2025-06-10&endTime=2025-06-10&page=1&perPage=100' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

企业专属版

查询部门使用数据

curl -X 'GET' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/lingma/organizations/c7655445-143f-4466-9724-8b371a21****/departmentUsage?departmentId=7b58e90a-063f-475b-ad6d-32d1f438****&startTime=2025-06-10&endTime=2025-06-10&page=1&perPage=100' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

请求头(Headers)

x-yunxiao-token string (必选)

个人访问令牌。您可参考个人访问令牌获取。

示例:pt-0fh3****0fbG_35af****0484。

请求参数

organizationId string (必选)

所属组织ID。您可以前往组织管理后台基本信息页面获取organizationId

departmentId string (必选)

部门 ID。请参见查询组织部门列表获取部门 ID。

startTime string (必选)

开始时间,格式为 YYYY-MM-DD。

endTime string (必选)

结束时间,格式为 YYYY-MM-DD。

page integer (可选)默认值为1

当前页。

perPage integer (可选)默认值为100

每页数据条数的最大值,取值范围:[1,100]

返回参数

返回示例

[
    {
        "activeDeveloper": 1,
        "activeDeveloperChat": 1,
        "activeDeveloperCompletion": 1,
        "breakdown": {
            "chatting": [
                {
                    "activeDeveloper": 1,
                    "chatTurns": 1,
                    "chatTurnsAccepted": 1,
                    "chatType": "GENERATE_TESTCASE",
                    "ide": "jetbrains"
                }
            ],
            "coding": [
                {
                    "acceptAssistantNewlineCount": 0,
                    "activeDeveloper": 1,
                    "language": "java",
                    "linesAccepted": 95,
                    "linesChanged": 95
                }
            ],
            "completion": [
                {
                    "activeDeveloper": 1,
                    "countAccepted": 3,
                    "countSuggested": 3,
                    "ide": "jetbrains",
                    "language": "java",
                    "linesAccepted": 5,
                    "linesSuggested": 5
                }
            ]
        },
        "date": 1749571200000,
        "departmentId": "68491a3e0dc52b6c963b****",
        "totalChatTurns": 1,
        "totalChatTurnsAccepted": 1,
        "totalCountAcceptedCompletion": 3,
        "totalCountSuggestedCompletion": 3,
        "totalLinesAccepted": 95,
        "totalLinesAcceptedChat": 0,
        "totalLinesAcceptedCompletion": 5,
        "totalLinesChanged": 95,
        "totalLinesSuggestedCompletion": 5
    }
]

activeDeveloper integer

活跃开发者数量。

activeDeveloperChat integer

问答活跃开发者数量。

activeDeveloperCompletion integer

代码生成活跃开发者数量。

breakdown Object

明细数据。

属性

chatting array

问答明细数据.

属性

activeDeveloper integer

活跃用户数。

chatTurns integer

问答次数。

chatTurnsAccepted integer

问答采纳次数。

chatType string

问答类型:

  • CODE_GENERATE_COMMENT:代码注释。

  • GENERATE_TESTCASE:单元测试。

  • EXPLAIN_CODE:代码解释。

  • OPTIMIZE_CODE:代码优化。

  • FREE_INPUT:自由问答,非大写字母串(自定义指令)。

ide string

ide 编辑器类型 jetbrains/vscode 等。

coding array

代码变更明细数据,包括行间补全、问答生成汇总采纳明细数据。

属性

acceptAssistantNewlineCount integer

该部门当天按问答和语言采纳的明细代码行数。

activeDeveloper integer

活跃用户数。

language string

语言。

linesAccepted integer

代码采纳行数。

linesChanged integer

代码变更行数。

completion array

行间补全生成采纳明细数据。

属性

activeDeveloper integer

活跃用户数。

couuntAccepted integer

采纳次数

countSuggested integer

推荐次数。

ide string

ide 编辑器类型 jetbrains/vscode 等。

language string

语言。

linesAccepted integer

代码采纳行数。

linesSuggested integer

代码推荐行数。

date integer

日期。

departmentId string

部门 ID。

totalChatTurns integer

该部门当天问答次数。

totalChatTurnsAccepted integer

该部门当天按问答方式采纳的次数。

totalCountAcceptedCompletion integer

该部门当天代码补全采纳的次数。

totalCountSuggestedCompletion integer

该部门当天代码补全推荐的次数。

totalLinesAccepted integer

该部门当天采纳代码行数,包括ask,edit(原ai程序员),agent问答生成和行间补全的总采纳行数。

totalLinesAcceptedChat integer

该部门当天按问答方式采纳的代码总行数。

totalLinesAcceptedCompletion integer

该部门当天代码补全采纳的代码总行数

totalLinesChanged integer

该部门当天变更行数,包括ask,edit(原ai程序员),agent问答生成和行间补全的总变更行数。

totalLinesSuggestedCompletion integer

该部门当天代码补全推荐的代码总行数

响应头

参数

描述

示例值

x-next-page

下一页

2

x-page

当前页

1

x-per-page

每页大小

100

x-prev-page

前一页

0

x-request-id

请求 ID

37294673-00CA-5B8B-914F-A8B35511E90A

x-total

总数

10

x-total-pages

总分页数

1

错误码

访问错误码中心查看 API 相关错误码。

相关文档

API使用中若遇到相关问题,请参见OpenAPI相关问题