tencent-docsCreate, read, list, search, and manage Tencent Docs (腾讯文档) — online documents, sheets, slides, mind maps, flowcharts, smart tables, and forms — via the Tencent Docs Open API. Use when the user mentions 腾讯文档 / Tencent Docs / docs.qq.com, a docs.qq.com link, or wants to create / read / organize a doc, sheet, slide, mind map, or flowchart in their Tencent Docs…
Independent GitHub snapshot · Automated classification · Original documentation governs
Drive the Tencent Docs Open API with
curl + jq. Everything runs in the user's own Tencent Docs account — only
files they can access, only the scopes they granted at connect time.
The tencentdocs BYOC connector injects three env vars; every call sends all
three headers:
TENCENTDOCS_ACCESS_TOKEN → Access-Token header (OAuth2 access token). Secret.TENCENTDOCS_CLIENT_ID → Client-Id header (the developer app's Client ID).TENCENTDOCS_OPEN_ID → Open-Id header (the user id returned with the token).All endpoints live under https://docs.qq.com/openapi. Define a reusable header
set once per session:
AUTH=(-H "Access-Token: $TENCENTDOCS_ACCESS_TOKEN" \
-H "Client-Id: $TENCENTDOCS_CLIENT_ID" \
-H "Open-Id: $TENCENTDOCS_OPEN_ID")
Never echo, print, or log TENCENTDOCS_ACCESS_TOKEN — it is full account access.
Every response is {"ret": 0, "msg": "Succeed", "data": {…}}. ret == 0
means success; any non-zero ret is an error — surface msg to the user.
Always check it:
resp=$(curl -sS "${AUTH[@]}" … )
echo "$resp" | jq 'if .ret == 0 then .data else error("Tencent Docs \(.ret): \(.msg)") end'
Common error codes:
| code | meaning | what to do |
|---|---|---|
400006 | access token invalid / expired | tell the user to reconnect 腾讯文档 at https://studio.acedata.cloud/console/connectors — do not loop-retry |
400007 | VIP (超级会员) privilege required | the requested capability needs a Tencent Docs 超级会员; tell the user, link https://docs.qq.com/vip |
400008 | 积分 (credits) insufficient | AI-generation quota is exhausted; tell the user to top up |
11607 / -32603 | bad request params | recheck fileID / type / body fields against the recipe below |
type when creating)| type | Product | Notes |
|---|---|---|
doc | 在线文档 (Word-style) | classic rich-text document |
sheet | 在线表格 (Excel) | data tables |
slide | 幻灯片 (PPT) | presentations |
mind | 思维导图 | mind map |
flowchart | 流程图 | flowchart |
smartsheet | 智能表格 | structured multi-view table |
form | 收集表 | form / survey |
Cheap sanity check — read the app's OpenAPI usage counter:
curl -sS "${AUTH[@]}" "https://docs.qq.com/openapi/drive/v2/util/resource-use" \
| jq 'if .ret == 0 then .data else "ERR \(.ret): \(.msg)" end'
If this returns 400006, the connection is expired — have the user reconnect.
/)curl -sS "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/folders/%2F?listType=folder&sortType=browse&asc=0" \
| jq 'if .ret == 0 then [.data.list[]? | {ID, title, type, url}] else . end'
%2F is the URL-encoded root folder id. For a sub-folder use its folder id in
the path.
curl -sS -G "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/search" \
--data-urlencode "searchName=Q1 预算" \
| jq 'if .ret == 0 then [.data.list[]? | {ID, title, type, url}] else . end'
The fileID is the last path segment of a https://docs.qq.com/doc/<id> (or
/sheet/, /slide/, …) URL.
curl -sS "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/files/FILE_ID/metadata" \
| jq 'if .ret == 0 then .data else . end'
curl -sS "${AUTH[@]}" \
"https://docs.qq.com/openapi/document/v3/files/FILE_ID/export?exportType=text" \
| jq 'if .ret == 0 then .data else . end'
Get the sheet's sheetId list from the metadata first, then read a range
(A1:D10):
curl -sS "${AUTH[@]}" \
"https://docs.qq.com/openapi/spreadsheet/v2/files/FILE_ID/sheets/SHEET_ID/values?range=A1:D10" \
| jq 'if .ret == 0 then .data.values else . end'
POST /openapi/drive/v2/files with form-urlencoded title + type. Returns the
new file's ID and url.
curl -sS -X POST "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/files" \
--data-urlencode "title=会议纪要 2026-07-03" \
--data-urlencode "type=doc" \
| jq 'if .ret == 0 then {ID: .data.ID, url: .data.url} else . end'
Swap type=sheet / slide / mind / flowchart / smartsheet / form for
other doc types. Pass --data-urlencode "folderID=<id>" to create inside a
folder instead of the root.
curl -sS -X POST "${AUTH[@]}" \
"https://docs.qq.com/openapi/resources/v2/images" \
-F "file=@./cover.png" \
| jq 'if .ret == 0 then .data else . end'
Show the user the current title + url and the new title, get an explicit
"yes", then run:
curl -sS -X PATCH "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/files/FILE_ID" \
--data-urlencode "title=新的标题" \
| jq 'if .ret == 0 then "renamed" else . end'
Show the user the file's current title + location and the destination folder,
get an explicit "yes", then run. folderID=/ moves it back to the root.
curl -sS -X PATCH "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/files/FILE_ID/move" \
--data-urlencode "folderID=DEST_FOLDER_ID" \
| jq 'if .ret == 0 then "moved" else . end'
curl -sS -X POST "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/files/FILE_ID/copy" \
--data-urlencode "title=副本 - 项目计划" \
| jq 'if .ret == 0 then {ID: .data.ID, url: .data.url} else . end'
Deletion moves the file to the recycle bin but is still destructive. Show the
user the exact title + url, get an explicit "yes", then run:
curl -sS -X DELETE "${AUTH[@]}" \
"https://docs.qq.com/openapi/drive/v2/files/FILE_ID" \
| jq 'if .ret == 0 then "deleted" else . end'
docs.qq.com/doc/<id> (or
/sheet/, /slide/, /mind/, /flowchart/, /form/, /smartsheet/) URL,
take the id from the path rather than asking for it.next marker in
data; pass it back to fetch the next page. Stop when the marker is empty.400007 / 400008 means the account tier / credits, not a
bug in the request.