查询统计表头

POST

/open-apis/attendance/v1/user_stats_fields/query

查询考勤统计支持的日度统计或月度统计的统计表头。

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	参数错误	请检查参数是否符合要求
400	1220002	租户不存在	请检查 tenant_access_token 是否正确
500	1228000	统计服务系统错误	详见错误信息

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/user_stats_fields/query?employee_type=employee_id' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "locale": "zh",
    "stats_type": "daily",
    "start_date": 20210316,
    "end_date": 20210323
}'

响应示例

{
  "code": 0,
  "msg": "",
  "data": {
    "user_stats_field": {
      "fields": [
        {
          "child_fields": [
            {
              "code": "50103",
              "title": "Employee ID"
            }
          ],
          "code": "501",
          "title": "Basic info"
        },
        {
          "child_fields": [
            {
              "code": "52108",
              "title": "Attendance group name"
            },
            {
              "code": "52101",
              "title": "Required attendance days"
            },
            {
              "code": "52102",
              "title": "Days of attendance"
            },
            {
              "code": "52104",
              "time_unit": "Minute",
              "title": "Required attendance duration"
            },
            {
              "code": "52105",
              "time_unit": "Minute",
              "title": "Actual attendance duration"
            },
            {
              "code": "52107",
              "title": "Overtime hours"
            }
          ],
          "code": "521",
          "title": "Attendance statistics"
        },
        {
          "child_fields": [
            {
              "code": "52201",
              "title": "Late in times"
            },
            {
              "code": "52203",
              "title": "Early out times"
            },
            {
              "code": "52207",
              "title": "No records"
            }
          ],
          "code": "522",
          "title": "Abnormal statistics"
        },
        {
          "child_fields": [
            {
              "code": "2021-03-16",
              "title": "2021-03-16 Tue"
            },
            {
              "code": "2021-03-17",
              "title": "2021-03-17 Wed"
            },
            {
              "code": "2021-03-18",
              "title": "2021-03-18 Thu"
            },
            {
              "code": "2021-03-19",
              "title": "2021-03-19 Fri"
            },
            {
              "code": "2021-03-20",
              "title": "2021-03-20 Sat"
            },
            {
              "code": "2021-03-21",
              "title": "2021-03-21 Sun"
            },
            {
              "code": "2021-03-22",
              "title": "2021-03-22 Mon"
            },
            {
              "code": "2021-03-23",
              "title": "2021-03-23 Tue"
            }
          ],
          "code": "524",
          "title": "Daily statistics"
        }
      ],
      "stats_type": "month",
      "user_id": "ec8ddg56"
    }
  }
}

请求参数

Query 参数

employee_type

必需

响应体中的 user_id 的员工工号类型示例值："employee_id" 可选值有： employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号

示例值:

employee_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

locale

string

必需

语言类型示例值："zh" 可选值有： en：英语 ja：日语 zh：中文

stats_type

string

必需

统计类型示例值："daily" 可选值有： daily：日度统计 month：月度统计

start_date

integer

必需

开始时间示例值：20210316

end_date

integer

必需

结束时间（时间间隔不超过 40 天）示例值：20210323

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

user_stats_field

object

统计数据表头

必需

修改于 2023-01-28 08:40:04

功能介绍

更新统计设置

查询统计表头

错误码#

请求参数

返回响应

错误码