明日方舟剧情搜索
搜索明日方舟剧情对话,支持关键词+类型筛选+分页
GET
https://api.tinyaii.cn/v1/ark/search
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| keyword | string | 必填 | 搜索关键词(角色名/台词) | — |
| type_filter | string | 可选 | 剧情类型:Main(主线)/Memory(干员密录)/Activity(活动)/Rogue(肉鸽),不传则不限 | — |
| offset | int | 可选 | 分页偏移,默认0 | — |
| limit | int | 可选 | 每页条数,1-50,默认20 | — |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| data.keyword | string | 搜索关键词 |
| data.total | int | 结果总数 |
| data.has_more | bool | 是否有更多结果 |
| data.results | array | 结果列表 |
| data.results[].story_id | string | 剧情ID |
| data.results[].type | string | 剧情类型代码 |
| data.results[].type_name | string | 剧情类型中文名 |
| data.results[].name | string | 剧情名称 |
| data.results[].zone | string | 所属章节 |
| data.results[].snippets | array | 匹配片段 |
返回示例
{
"code": 200,
"message": "success",
"data": {
"keyword": "阿米娅",
"total": 380,
"has_more": true,
"results": [
{
"story_id": "obt/main/level_main_00-01_beg",
"type": "Main",
"type_name": "主线剧情",
"name": "0-1 坍塌 行动前",
"zone": "黑暗时代·上"
}
]
}
}
调用示例
curl "https://api.tinyaii.cn/v1/ark/search?keyword=<keyword>" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch("https://api.tinyaii.cn/v1/ark/search?keyword=<keyword>", {
headers: { "Authorization": "Bearer YOUR_API_KEY" },
});
console.log(await res.json());import requests
resp = requests.get(
"https://api.tinyaii.cn/v1/ark/search",
params={"keyword": "<keyword>"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=10,
)
print(resp.json())把 YOUR_API_KEY 换成你的密钥即可直接运行。密钥只保存在你自己的设备上。