主题
搜索文档内容
搜索文档内容,只能在本应用文件夹内进行
基本信息
请求方法:GET
请求路径:/api/v1/openapi/personal/files/search/content
请求主机:developer.kdocs.cn
限流频次
应用类型 | 限额 |
---|---|
测试应用 | 10,000 次/天 |
正式应用 | 1,000,000 次/天 |
权限范围
权限值 | 显示名称 | 权限说明 |
---|---|---|
access_personal_files | 访问个人文档 | 访问用户个人文档列表 |
Query 参数
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | |
content | 是 | string | 搜索内容,长度限制为 100 |
parent_id | 否 | string | 搜索根目录文件夹 id |
count | 否 | integer | 获取文档数量,默认为 30 |
offset | 否 | integer | 获取文档列表的偏移值,默认为 0 |
返回参数
参数 | 类型 | 说明 |
---|---|---|
code | integer | 错误码 |
data | data {} | 响应数据 |
示例
请求示例
curl --request GET \
--url 'https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1'
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1")
.get()
.build();
Response response = client.newCall(request).execute();
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
import http.client
conn = http.client.HTTPSConnection("developer.kdocs.cn")
conn.request("GET", "/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
const data = null;
const xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === this.DONE) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1");
xhr.send(data);
const http = require("https");
const options = {
"method": "GET",
"hostname": "developer.kdocs.cn",
"port": null,
"path": "/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1",
"headers": {}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1");
CURLcode ret = curl_easy_perform(hnd);
var client = new RestClient("https://developer.kdocs.cn/api/v1/openapi/personal/files/search/content?access_token=kvqxrspxjctdojjqdildjhonzwusaquc&count=3&open_parentid=6-8M9ysR7atjqiLilbLQbL89g7Jqav5EkNjryor8jBw&content=1");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
返回示例
{
"code": 0,
"data": {
"files": [
{
"id": {
"open_id": "IiK_uK_--aOg1yLckuyr2NbIAc2w15FDuGW_O26ZeEA",
"union_id": "6-8M9ysR7atjqiLilbLQbNbIAc2w15FDuGW_O26ZeEA"
},
"file_name": "工作簿(1).xlsx",
"file_type": "file",
"ctime": 1648544352,
"mtime": 1648544352,
"path": "我的云文档"
},
{
"id": {
"open_id": "IiK_uK_--aOg1yLckuyr2IG4vYA-PlfgVd2AxmN3gQI",
"union_id": "6-8M9ysR7atjqiLilbLQbIG4vYA-PlfgVd2AxmN3gQI"
},
"file_name": "1.xlsx",
"file_type": "sharefile",
"ctime": 1650792146,
"mtime": 1653534738,
"path": "与我共享"
},
{
"id": {
"open_id": "IiK_uK_--aOg1yLckuyr2GnUaYe6o3JYN5VfS7GxAw4",
"union_id": "6-8M9ysR7atjqiLilbLQbGnUaYe6o3JYN5VfS7GxAw4"
},
"file_name": "未命名文档(197).docx",
"file_type": "sharefile",
"ctime": 1651830293,
"mtime": 1651830496,
"path": "与我共享"
}
]
}
}
错误码
请参考错误码说明