创建 OKR 进展记录
POST
https://open.feishu.cn/open-apis/okr/v1/progress_records
错误码
| 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的数据不存在 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/okr/v1/progress_records?user_id_type=' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"source_title":"测试周报系统",
"source_url":"https://www.baidu.com/",
"target_id":"7043693679567028244",
"target_type":2,
"content":{
"blocks":[
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"粗体验证",
"style":{
"bold":true
}
}
}
]
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"*",
"style":{
"bold":true
}
}
},
{
"type":"textRun",
"textRun":{
"text":"删除线验证",
"style":{
"strikeThrough":true
}
}
}
]
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"字体颜色验证",
"style":{
"textColor":{
"red":216,
"green":57,
"blue":49,
"alpha":1
}
}
}
}
]
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"背景颜色验证",
"style":{
"backColor":{
"red":251,
"green":191,
"blue":188,
"alpha":1
}
}
}
}
]
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"粗体+删除+字体颜色+背景颜色验证",
"style":{
"bold":true,
"strikeThrough":true,
"backColor":{
"red":251,
"green":191,
"blue":188,
"alpha":1
},
"textColor":{
"red":216,
"green":57,
"blue":49,
"alpha":1
}
}
}
}
]
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"有序标题1验证，",
"style":{
}
}
},
{
"type":"textRun",
"textRun":{
"text":"粗体验证",
"style":{
"bold":true
}
}
}
],
"style":{
"list":{
"type":"number",
"indentLevel":1,
"number":1
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"有序标题2验证，",
"style":{
}
}
},
{
"type":"textRun",
"textRun":{
"text":"删除线验证",
"style":{
"strikeThrough":true
}
}
}
],
"style":{
"list":{
"type":"number",
"indentLevel":1,
"number":2
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"有序标题3验证，",
"style":{
}
}
},
{
"type":"textRun",
"textRun":{
"text":"字体背景颜色验证",
"style":{
"backColor":{
"red":251,
"green":191,
"blue":188,
"alpha":1
},
"textColor":{
"red":216,
"green":57,
"blue":49,
"alpha":1
}
}
}
}
],
"style":{
"list":{
"type":"number",
"indentLevel":1,
"number":3
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"无序标题1验证，",
"style":{
}
}
},
{
"type":"textRun",
"textRun":{
"text":"粗体",
"style":{
"bold":true
}
}
}
],
"style":{
"list":{
"type":"bullet",
"indentLevel":1
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"无序标题2验证，",
"style":{
}
}
},
{
"type":"textRun",
"textRun":{
"text":"删除线",
"style":{
"strikeThrough":true
}
}
}
],
"style":{
"list":{
"type":"bullet",
"indentLevel":1
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"无序标题3验证，",
"style":{
}
}
},
{
"type":"textRun",
"textRun":{
"text":"字体背景颜色验证",
"style":{
"backColor":{
"red":251,
"green":191,
"blue":188,
"alpha":1
},
"textColor":{
"red":216,
"green":57,
"blue":49,
"alpha":1
}
}
}
}
],
"style":{
"list":{
"type":"bullet",
"indentLevel":1
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"https://bytedance.feishu.cn/docx/doxcnO2Wkq0YPZQYLuJKyyOvLrh#doxcnSOui82swqk6c0o436Ak3nc",
"style":{
"link":{
"url":"https://bytedance.feishu.cn/docx/doxcnO2Wkq0YPZQYLuJKyyOvLrh#doxcnSOui82swqk6c0o436Ak3nc"
}
}
}
}
]
}
},
{
"type":"gallery",
"gallery":{
"imageList":[
{
"src":"https://internal-api-okr.feishu-boe.cn/stream/api/downloadFile/?file_token=boxbcMTBQO9ofLjWkDuPxkxOA2c&ticket=eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJ0YXJnZXRfaWQiOiI3MDQxNDMwMzc3NjQyMDgyMzIzIiwidGFyZ2V0X3R5cGUiOjMsImFjdGlvbiI6MiwiZmlsZV90b2tlbiI6ImJveGJjTVRCUU85b2ZMaldrRHVQeGt4T0EyYyIsInVzZXJfaWQiOiI2OTY5ODU1NTAxNzQ0ODM0MDkyIiwidGVuYW50X2lkIjoiNjg3NzUwMjY4NzYwOTQwNjk5MCIsImV4cCI6MTY0MDE1NTk2M30.yc4qV2pkGUVwSO53-N_XGgeMucjmDn9iso1Ez_8vpghFz8YdeSDf4NHQpxOHYHc8RURvwI0a5UTNKKJ9CWagTQ",
"fileToken":"boxbcMTBQO9ofLjWkDuPxkxOA2c",
"width":458,
"height":372
}
]
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"任务列表未勾选验证",
"style":{
}
}
}
],
"style":{
"list":{
"type":"checkBox",
"indentLevel":1
}
}
}
},
{
"type":"paragraph",
"paragraph":{
"elements":[
{
"type":"textRun",
"textRun":{
"text":"任务列表已勾选验证",
"style":{
}
}
}
],
"style":{
"list":{
"type":"checkedBox",
"indentLevel":1
}
}
}
}
]
}
}'响应示例响应示例
{
"code": 0,
"data": {
"content": {
"blocks": [
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {
"bold": true
},
"text": "粗体验证"
},
"type": "textRun"
}
]
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {
"bold": true
},
"text": "*"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"strikeThrough": true
},
"text": "删除线验证"
},
"type": "textRun"
}
]
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {
"textColor": {
"alpha": 1,
"blue": 49,
"green": 57,
"red": 216
}
},
"text": "字体颜色验证"
},
"type": "textRun"
}
]
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {
"backColor": {
"alpha": 1,
"blue": 188,
"green": 191,
"red": 251
}
},
"text": "背景颜色验证"
},
"type": "textRun"
}
]
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {
"backColor": {
"alpha": 1,
"blue": 188,
"green": 191,
"red": 251
},
"bold": true,
"strikeThrough": true,
"textColor": {
"alpha": 1,
"blue": 49,
"green": 57,
"red": 216
}
},
"text": "粗体+删除+字体颜色+背景颜色验证"
},
"type": "textRun"
}
]
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "有序标题1验证，"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"bold": true
},
"text": "粗体验证"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"number": 1,
"type": "number"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "有序标题2验证，"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"strikeThrough": true
},
"text": "删除线验证"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"number": 2,
"type": "number"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "有序标题3验证，"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"backColor": {
"alpha": 1,
"blue": 188,
"green": 191,
"red": 251
},
"textColor": {
"alpha": 1,
"blue": 49,
"green": 57,
"red": 216
}
},
"text": "字体背景颜色验证"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"number": 3,
"type": "number"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "无序标题1验证，"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"bold": true
},
"text": "粗体"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"type": "bullet"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "无序标题2验证，"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"strikeThrough": true
},
"text": "删除线"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"type": "bullet"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "无序标题3验证，"
},
"type": "textRun"
},
{
"textRun": {
"style": {
"backColor": {
"alpha": 1,
"blue": 188,
"green": 191,
"red": 251
},
"textColor": {
"alpha": 1,
"blue": 49,
"green": 57,
"red": 216
}
},
"text": "字体背景颜色验证"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"type": "bullet"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {
"link": {
"url": "https://bytedance.feishu.cn/docx/doxcnO2Wkq0YPZQYLuJKyyOvLrh#doxcnSOui82swqk6c0o436Ak3nc"
}
},
"text": "https://bytedance.feishu.cn/docx/doxcnO2Wkq0YPZQYLuJKyyOvLrh#doxcnSOui82swqk6c0o436Ak3nc"
},
"type": "textRun"
}
]
},
"type": "paragraph"
},
{
"gallery": {
"imageList": [
{
"fileToken": "boxbcMTBQO9ofLjWkDuPxkxOA2c",
"height": 372,
"src": "https://internal-api-okr.feishu-boe.cn/stream/api/downloadFile/?file_token=boxbcMTBQO9ofLjWkDuPxkxOA2c&ticket=eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJ0YXJnZXRfaWQiOiI3MDQxNDMwMzc3NjQyMDgyMzIzIiwidGFyZ2V0X3R5cGUiOjMsImFjdGlvbiI6MiwiZmlsZV90b2tlbiI6ImJveGJjTVRCUU85b2ZMaldrRHVQeGt4T0EyYyIsInVzZXJfaWQiOiI2OTY5ODU1NTAxNzQ0ODM0MDkyIiwidGVuYW50X2lkIjoiNjg3NzUwMjY4NzYwOTQwNjk5MCIsImV4cCI6MTY0MDE1NTk2M30.yc4qV2pkGUVwSO53-N_XGgeMucjmDn9iso1Ez_8vpghFz8YdeSDf4NHQpxOHYHc8RURvwI0a5UTNKKJ9CWagTQ",
"width": 458
}
]
},
"type": "gallery"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "任务列表未勾选验证"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"type": "checkBox"
}
}
},
"type": "paragraph"
},
{
"paragraph": {
"elements": [
{
"textRun": {
"style": {},
"text": "任务列表已勾选验证"
},
"type": "textRun"
}
],
"style": {
"list": {
"indentLevel": 1,
"type": "checkedBox"
}
}
},
"type": "paragraph"
}
]
},
"modify_time": "1640675837810",
"progress_id": "7046317985098760212"
},
"msg": "success"
}请求参数
Query 参数
user_id_type
string
可选
union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？
user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？
默认值：open_id
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
扫码加入交流群修改于 2023-02-07 07:19:56