获取成员使用数据列表

通过 OpenAPI 获取使用过通义灵码的开发者数据。

适用版本

企业专属版、企业标准版

服务接入点

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

授权信息

产品

资源

所需权限

通义灵码

开发者使用统计

只读

请求语法

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

请求说明

企业标准版

查询所有用户使用数据

curl -X 'GET' \
  'https://openapi-rdc.aliyuncs.com/oapi/v1/lingma/organizations/67d8e0b9120358055abf****/developerUsage?startTime=2024-02-01&endTime=2025-05-31' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

查询指定用户使用数据

curl -X 'GET' \
  'https://openapi-rdc.aliyuncs.com/oapi/v1/lingma/organizations/67d8e0b9120358055abf****/developerUsage?userId=3693e234****&startTime=2024-02-01&endTime=2025-05-31' \
  -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/67d8e0b9120358055abf****/developerUsage?startTime=2024-02-01&endTime=2025-05-31' \
  -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/67d8e0b9120358055abf****/developerUsage?userId=3693e234****&startTime=2024-02-01&endTime=2025-05-31' \
  -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。您可前往组织管理后台的基本信息页面获取

startTime string (必选)

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

endtime string (必选)

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

userId string (可选)

用户 ID。

用户 ID 与部门 ID 选择一个即可。如果两个参数同时传值,会以用户 ID 过滤 ;如果同时不传值,会查询企业下所有用户数据。

departmentId string (可选)

部门 ID。

用户 ID 与部门 ID 选择一个即可。如果两个参数同时传值,会以用户 ID 过滤 ;如果同时不传值,会查询企业下所有用户数据。

page integer (可选)默认值为1

当前页。

perPage integer (可选)默认值为100

每页数据条数。

返回参数

返回所有用户使用数据

[
    {
        "breakdown": {
            "chatting": [
                {
                    "chatTurns": 1,
                    "chatTurnsAccepted": 1,
                    "chatType": "GENERATE_TESTCASE",
                    "ide": "jetbrains"
                }
            ],
            "coding": [
                {
                    "acceptAssistantNewlineCount": 0,
                    "language": "java",
                    "linesAccepted": 79,
                    "linesChanged": 79
                }
            ],
            "completion": [
                {
                    "countAccepted": 1,
                    "countSuggested": 1,
                    "ide": "jetbrains",
                    "language": "java",
                    "linesAccepted": 1,
                    "linesSuggested": 1
                }
            ]
        },
        "date": 1749484800000,
        "statusActive": true,
        "statusActiveChat": true,
        "statusActiveCompletion": true,
        "statusActiveLastedTime": 1749570900000,
        "totalChatTurns": 1,
        "totalChatTurnsAccepted": 1,
        "totalCountAcceptedCompletion": 1,
        "totalCountSuggestedCompletion": 1,
        "totalLinesAccepted": 79,
        "totalLinesAcceptedChat": 0,
        "totalLinesAcceptedCompletion": 1,
        "totalLinesChanged": 79,
        "totalLinesSuggestedCompletion": 1,
        "userId": "10107ac8-59af-4391-8df5-ea4472bb****"
    }
]

返回指定用户使用数据

[
    {
        "breakdown": {
            "chatting": [
                {
                    "chatTurns": 1,
                    "chatTurnsAccepted": 1,
                    "chatType": "GENERATE_TESTCASE",
                    "ide": "jetbrains"
                }
            ],
            "coding": [
                {
                    "acceptAssistantNewlineCount": 0,
                    "language": "java",
                    "linesAccepted": 79,
                    "linesChanged": 79
                }
            ],
            "completion": [
                {
                    "countAccepted": 1,
                    "countSuggested": 1,
                    "ide": "jetbrains",
                    "language": "java",
                    "linesAccepted": 1,
                    "linesSuggested": 1
                }
            ]
        },
        "date": 1749484800000,
        "statusActive": true,
        "statusActiveChat": true,
        "statusActiveCompletion": true,
        "statusActiveLastedTime": 1749570900000,
        "totalChatTurns": 1,
        "totalChatTurnsAccepted": 1,
        "totalCountAcceptedCompletion": 1,
        "totalCountSuggestedCompletion": 1,
        "totalLinesAccepted": 79,
        "totalLinesAcceptedChat": 0,
        "totalLinesAcceptedCompletion": 1,
        "totalLinesChanged": 79,
        "totalLinesSuggestedCompletion": 1,
        "userId": "10107ac8-59af-4391-8df5-ea4472bb****"
    }
]

breakdown Object

明细数据。

属性

chatting array

问答明细数据。

属性

chatTurns integer

问答次数。

chatTurnsAccepted integer

问答采纳次数。

chatTypestring

问答类型:

  • CODE_GENERATE_COMMENT:代码注释

  • GENERATE_TESTCASE:单元测试

  • EXPLAIN_CODE:代码解释

  • OPTIMIZE_CODE:代码优化

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

ide string

IDE 编辑器类型 JetBrains/VsCode 等。

coding array

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

属性

language string

语言。

linesAccepted integer

代码采纳行数。

linesChanged integer

代码变更行数。

acceptAssistantNewlineCountinteger

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

completion array

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

属性

couuntAccepted integer

采纳次数。

countSuggested integer

推荐次数。

ide string

ide 编辑器类型 jetbrains/vscode 等。

language string

语言。

linesAccepted integer

代码采纳行数。

linesChangedinteger

代码变更行数。

date integer

日期。

statusActive boolean

该用户是否活跃。

  • true:用户活跃。

  • false:用户不活跃。

statusActiveChat boolean

该用户是否活跃在问答。

  • true:用户活跃在问答。

  • false:用户不活跃问答。

statusActiveCompletion boolean

该用户是否活跃在代码生成。

  • true:用户活跃在代码生成。

  • false:用户不活跃在代码生成。

statusActiveLastedTime string

该用户当天最后的活跃时刻。

totalChatTurns integer

该用户当天问答次数。

totalLinesAcceptedChat integer

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

totalLinesAccepted integer

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

totalLinesChanged integer

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

totalLinesSuggestedCompletion integer

该用户当天行间补全生成变更代码总行数。

totalLinesAcceptedCompletion integer

该用户当天行间补全生成代码采纳总行数。

totalCountSuggestedCompletion integer

该用户当天行间补全生成代码推荐总次数。

totalCountAcceptedCompletion  integer

该用户当天行间补全生成代码采纳总次数。

totalChatTurnsAccepted integer

该用户当天问答采纳总次数。

userId string

用户 ID。

响应头

参数

描述

示例值

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 相关错误码。