获取OKR周期列表

GET

/okr/v1/periods

获取OKR周期列表
使用tenant_access_token需要额外申请权限
以应用身份访问OKR信息

错误码

HTTP状态码	错误码	描述	排查建议
500	1009999	Unknown error. Please contact Feishu Assistant or your customer success manager.	内部错误，请联系飞书助手或您的客户成功经理
500	1009998	system exception	系统异常
400	1001001	Invalid parameters. Please check document and modify accordingly.	无效的参数，请对照文档检查输入的参数
400	1001002	No permission.	您无权访问该接口，请确认您的登录凭证
400	1001003	User not found.	用户不存在
400	1001004	OKR data not found.	对应ID的数据不存在

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

返回响应

🟢200200 Success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/okr/v1/periods?page_token=xaasdasdax&page_size=10' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "data": {
        "has_more": false,
        "items": [
            {
                "en_name": "Jan - Mar 2022",
                "id": "7071200999834255380",
                "status": 0,
                "zh_name": "2022 年 1 月 - 3 月"
            }
        ]
    },
    "msg": "success"
}

修改于 2025-10-21 08:26:23

概述

获取用户的 OKR 列表

获取OKR周期列表

错误码#

请求参数

返回响应

错误码