API 开发者中心
Memex Server API
先跑通业务,再查字段。
这里按开发任务组织文档。选择你要完成的事情,指南负责带你跑通; 需要确认参数、响应或状态码时,再进入自动生成的端点参考。
你想完成什么
01检索并下载 Wiki分页查询可发布 Wiki,下载完整包并校验 SHA-256。02上传并生成 Wiki提交 EPUB、PDF 或 Markdown,获取 job 与 wiki 标识。03跟踪长任务轮询 job 状态,或通过 SSE 接收阶段与完成事件。04读取生成内容获取页面、搜索结果、关系图和 Wiki 统计数据。
第一个请求
所有正式接口都使用同一个服务地址和 Bearer token:
export MEMEX_HOST=https://memex-server.memect.cn
export MEMEX_TOKEN=sk-memex-xxxxxxxx
curl --fail-with-body \
-H "Authorization: Bearer $MEMEX_TOKEN" \
"$MEMEX_HOST/api/v1/auth/me"
如果返回当前用户、角色和 token ID,认证已经配置正确。接下来直接选择上面的任务指南。
Base URL
/api/v1认证
Bearer token格式
JSON · multipart · SSE版本策略
稳定路径 + OpenAPI指南与端点参考怎么用
| 你现在的问题 | 去哪里 |
|---|---|
| “怎样完成一次检索和下载?” | 阅读对应的开发指南 |
| “这个字段是否必填?” | 打开API 端点中的请求参数 |
| “409、413、429 分别怎么处理?” | 查看端点的响应状态与指南中的恢复策略 |
| “服务当前到底暴露了什么?” | 以自动生成的 OpenAPI 端点参考为准 |
推荐顺序
第一次接入先读一篇任务指南并复制完整示例。联调阶段再把端点参考作为字段字典使用,不需要从 60 多个端点中猜入口。