Skip to content

Commit dff18f3

Browse files
ysyneuysyneu
authored
docs(safari): drop skill/download from public API (now jwt console-only) (#106)
/safari/skill/download is reclassified auth=all -> jwt in the registry (fc-pgy #570): it is a console-only binary (application/zip) download used by the Customize UI via the session cookie, with no app_key consumer. Remove it from the public OpenAPI specs (per-module + consolidated, en+zh), the docs.json navigation, and the api-catalog overview (AI SRE 26->25, total 240->239). Mirrors the session/cancel removal (#101).
1 parent 1e7454c commit dff18f3

7 files changed

Lines changed: 4 additions & 332 deletions

File tree

‎api-reference/openapi.en.json‎

Lines changed: 0 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -20864,74 +20864,6 @@
2086420864
}
2086520865
}
2086620866
},
20867-
"/safari/skill/download": {
20868-
"post": {
20869-
"operationId": "skill-read-download",
20870-
"summary": "Download skill",
20871-
"description": "Download a skill's zip archive by ID.",
20872-
"tags": [
20873-
"AI SRE/Skills"
20874-
],
20875-
"security": [
20876-
{
20877-
"AppKeyAuth": []
20878-
}
20879-
],
20880-
"x-mint": {
20881-
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **60 requests/minute**; **5 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- Returns the raw zip bytes (`application/zip`), not the JSON envelope. The filename is the skill name.\n",
20882-
"href": "/en/api-reference/ai-sre/skills/skill-read-download",
20883-
"metadata": {
20884-
"sidebarTitle": "Download skill"
20885-
}
20886-
},
20887-
"responses": {
20888-
"200": {
20889-
"description": "Skill archive (zip).",
20890-
"headers": {
20891-
"Content-Disposition": {
20892-
"description": "attachment; filename=<skill_name>.zip",
20893-
"schema": {
20894-
"type": "string"
20895-
}
20896-
}
20897-
},
20898-
"content": {
20899-
"application/zip": {
20900-
"schema": {
20901-
"type": "string",
20902-
"format": "binary"
20903-
}
20904-
}
20905-
}
20906-
},
20907-
"400": {
20908-
"$ref": "#/components/responses/BadRequest"
20909-
},
20910-
"401": {
20911-
"$ref": "#/components/responses/Unauthorized"
20912-
},
20913-
"429": {
20914-
"$ref": "#/components/responses/TooManyRequests"
20915-
},
20916-
"500": {
20917-
"$ref": "#/components/responses/ServerError"
20918-
}
20919-
},
20920-
"requestBody": {
20921-
"required": true,
20922-
"content": {
20923-
"application/json": {
20924-
"schema": {
20925-
"$ref": "#/components/schemas/SkillDownloadRequest"
20926-
},
20927-
"example": {
20928-
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
20929-
}
20930-
}
20931-
}
20932-
}
20933-
}
20934-
},
2093520867
"/safari/skill/enable": {
2093620868
"post": {
2093720869
"operationId": "skill-read-enable",
@@ -39844,19 +39776,6 @@
3984439776
"description"
3984539777
]
3984639778
},
39847-
"SkillDownloadRequest": {
39848-
"type": "object",
39849-
"description": "Skill zip download by ID.",
39850-
"properties": {
39851-
"skill_id": {
39852-
"type": "string",
39853-
"description": "Target skill ID."
39854-
}
39855-
},
39856-
"required": [
39857-
"skill_id"
39858-
]
39859-
},
3986039779
"GetWarRoomDefaultObserversResponse": {
3986139780
"type": "object",
3986239781
"properties": {

‎api-reference/openapi.zh.json‎

Lines changed: 0 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -20856,74 +20856,6 @@
2085620856
}
2085720857
}
2085820858
},
20859-
"/safari/skill/download": {
20860-
"post": {
20861-
"operationId": "skill-read-download",
20862-
"summary": "下载技能",
20863-
"description": "按 ID 下载技能的 zip 压缩包。",
20864-
"tags": [
20865-
"AI SRE/技能"
20866-
],
20867-
"security": [
20868-
{
20869-
"AppKeyAuth": []
20870-
}
20871-
],
20872-
"x-mint": {
20873-
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **60 次/分钟**；**5 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |\n\n## 使用说明\n\n- 返回原始 zip 字节流（`application/zip`），而非 JSON 信封。文件名为技能名称。\n",
20874-
"href": "/zh/api-reference/ai-sre/skills/skill-read-download",
20875-
"metadata": {
20876-
"sidebarTitle": "下载技能"
20877-
}
20878-
},
20879-
"responses": {
20880-
"200": {
20881-
"description": "技能压缩包（zip）。",
20882-
"headers": {
20883-
"Content-Disposition": {
20884-
"description": "attachment; filename=<skill_name>.zip",
20885-
"schema": {
20886-
"type": "string"
20887-
}
20888-
}
20889-
},
20890-
"content": {
20891-
"application/zip": {
20892-
"schema": {
20893-
"type": "string",
20894-
"format": "binary"
20895-
}
20896-
}
20897-
}
20898-
},
20899-
"400": {
20900-
"$ref": "#/components/responses/BadRequest"
20901-
},
20902-
"401": {
20903-
"$ref": "#/components/responses/Unauthorized"
20904-
},
20905-
"429": {
20906-
"$ref": "#/components/responses/TooManyRequests"
20907-
},
20908-
"500": {
20909-
"$ref": "#/components/responses/ServerError"
20910-
}
20911-
},
20912-
"requestBody": {
20913-
"required": true,
20914-
"content": {
20915-
"application/json": {
20916-
"schema": {
20917-
"$ref": "#/components/schemas/SkillDownloadRequest"
20918-
},
20919-
"example": {
20920-
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
20921-
}
20922-
}
20923-
}
20924-
}
20925-
}
20926-
},
2092720859
"/safari/skill/enable": {
2092820860
"post": {
2092920861
"operationId": "skill-read-enable",
@@ -39835,19 +39767,6 @@
3983539767
"description"
3983639768
]
3983739769
},
39838-
"SkillDownloadRequest": {
39839-
"type": "object",
39840-
"description": "按 ID 下载技能压缩包。",
39841-
"properties": {
39842-
"skill_id": {
39843-
"type": "string",
39844-
"description": "目标技能 ID。"
39845-
}
39846-
},
39847-
"required": [
39848-
"skill_id"
39849-
]
39850-
},
3985139770
"GetWarRoomDefaultObserversResponse": {
3985239771
"type": "object",
3985339772
"properties": {

‎api-reference/safari.openapi.en.json‎

Lines changed: 0 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -519,74 +519,6 @@
519519
}
520520
}
521521
},
522-
"/safari/skill/download": {
523-
"post": {
524-
"operationId": "skill-read-download",
525-
"summary": "Download skill",
526-
"description": "Download a skill's zip archive by ID.",
527-
"tags": [
528-
"AI SRE/Skills"
529-
],
530-
"security": [
531-
{
532-
"AppKeyAuth": []
533-
}
534-
],
535-
"x-mint": {
536-
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **60 requests/minute**; **5 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- Returns the raw zip bytes (`application/zip`), not the JSON envelope. The filename is the skill name.\n",
537-
"href": "/en/api-reference/ai-sre/skills/skill-read-download",
538-
"metadata": {
539-
"sidebarTitle": "Download skill"
540-
}
541-
},
542-
"responses": {
543-
"200": {
544-
"description": "Skill archive (zip).",
545-
"headers": {
546-
"Content-Disposition": {
547-
"description": "attachment; filename=<skill_name>.zip",
548-
"schema": {
549-
"type": "string"
550-
}
551-
}
552-
},
553-
"content": {
554-
"application/zip": {
555-
"schema": {
556-
"type": "string",
557-
"format": "binary"
558-
}
559-
}
560-
}
561-
},
562-
"400": {
563-
"$ref": "#/components/responses/BadRequest"
564-
},
565-
"401": {
566-
"$ref": "#/components/responses/Unauthorized"
567-
},
568-
"429": {
569-
"$ref": "#/components/responses/TooManyRequests"
570-
},
571-
"500": {
572-
"$ref": "#/components/responses/ServerError"
573-
}
574-
},
575-
"requestBody": {
576-
"required": true,
577-
"content": {
578-
"application/json": {
579-
"schema": {
580-
"$ref": "#/components/schemas/SkillDownloadRequest"
581-
},
582-
"example": {
583-
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
584-
}
585-
}
586-
}
587-
}
588-
}
589-
},
590522
"/safari/skill/enable": {
591523
"post": {
592524
"operationId": "skill-read-enable",
@@ -2785,19 +2717,6 @@
27852717
"skill_id"
27862718
]
27872719
},
2788-
"SkillDownloadRequest": {
2789-
"type": "object",
2790-
"description": "Skill zip download by ID.",
2791-
"properties": {
2792-
"skill_id": {
2793-
"type": "string",
2794-
"description": "Target skill ID."
2795-
}
2796-
},
2797-
"required": [
2798-
"skill_id"
2799-
]
2800-
},
28012720
"SkillUpdateRequest": {
28022721
"type": "object",
28032722
"description": "Editable skill metadata.",

‎api-reference/safari.openapi.zh.json‎

Lines changed: 0 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -519,74 +519,6 @@
519519
}
520520
}
521521
},
522-
"/safari/skill/download": {
523-
"post": {
524-
"operationId": "skill-read-download",
525-
"summary": "下载技能",
526-
"description": "按 ID 下载技能的 zip 压缩包。",
527-
"tags": [
528-
"AI SRE/技能"
529-
],
530-
"security": [
531-
{
532-
"AppKeyAuth": []
533-
}
534-
],
535-
"x-mint": {
536-
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **60 次/分钟**；**5 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |\n\n## 使用说明\n\n- 返回原始 zip 字节流（`application/zip`），而非 JSON 信封。文件名为技能名称。\n",
537-
"href": "/zh/api-reference/ai-sre/skills/skill-read-download",
538-
"metadata": {
539-
"sidebarTitle": "下载技能"
540-
}
541-
},
542-
"responses": {
543-
"200": {
544-
"description": "技能压缩包（zip）。",
545-
"headers": {
546-
"Content-Disposition": {
547-
"description": "attachment; filename=<skill_name>.zip",
548-
"schema": {
549-
"type": "string"
550-
}
551-
}
552-
},
553-
"content": {
554-
"application/zip": {
555-
"schema": {
556-
"type": "string",
557-
"format": "binary"
558-
}
559-
}
560-
}
561-
},
562-
"400": {
563-
"$ref": "#/components/responses/BadRequest"
564-
},
565-
"401": {
566-
"$ref": "#/components/responses/Unauthorized"
567-
},
568-
"429": {
569-
"$ref": "#/components/responses/TooManyRequests"
570-
},
571-
"500": {
572-
"$ref": "#/components/responses/ServerError"
573-
}
574-
},
575-
"requestBody": {
576-
"required": true,
577-
"content": {
578-
"application/json": {
579-
"schema": {
580-
"$ref": "#/components/schemas/SkillDownloadRequest"
581-
},
582-
"example": {
583-
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
584-
}
585-
}
586-
}
587-
}
588-
}
589-
},
590522
"/safari/skill/enable": {
591523
"post": {
592524
"operationId": "skill-read-enable",
@@ -2785,19 +2717,6 @@
27852717
"skill_id"
27862718
]
27872719
},
2788-
"SkillDownloadRequest": {
2789-
"type": "object",
2790-
"description": "按 ID 下载技能压缩包。",
2791-
"properties": {
2792-
"skill_id": {
2793-
"type": "string",
2794-
"description": "目标技能 ID。"
2795-
}
2796-
},
2797-
"required": [
2798-
"skill_id"
2799-
]
2800-
},
28012720
"SkillUpdateRequest": {
28022721
"type": "object",
28032722
"description": "可编辑的技能元数据。",

‎docs.json‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1058,7 +1058,6 @@
10581058
"POST /safari/skill/update",
10591059
"POST /safari/skill/delete",
10601060
"POST /safari/skill/upload",
1061-
"POST /safari/skill/download",
10621061
"POST /safari/skill/enable",
10631062
"POST /safari/skill/disable"
10641063
]
@@ -2179,7 +2178,6 @@
21792178
"POST /safari/skill/update",
21802179
"POST /safari/skill/delete",
21812180
"POST /safari/skill/upload",
2182-
"POST /safari/skill/download",
21832181
"POST /safari/skill/enable",
21842182
"POST /safari/skill/disable"
21852183
]

0 commit comments

Comments
 (0)