# Meta API (/docs/api/native/meta)



## 基础地址 [#基础地址]

<ApiBaseDomain prefix="/meta" />

## 接入 [#接入]

<QuickstartTabs snippets="{&#x22;curl&#x22;:&#x22;curl https://api-origin.invalid/meta/v1/health&#x22;,&#x22;python&#x22;:&#x22;import os\n\nimport requests\n\nopts = dict(\n    base_url=\&#x22;https://api-origin.invalid/meta\&#x22;,\n)\n\nresp = requests.get(f\&#x22;{opts['base_url']}/v1/health\&#x22;)\nprint(resp.text)&#x22;,&#x22;typescript&#x22;:&#x22;\n\nconst opts = {\n  baseURL: \&#x22;https://api-origin.invalid/meta\&#x22;,\n};\n\nconst resp = await fetch(`${opts.baseURL}/v1/health`);\nconsole.log(await resp.text());&#x22;}" />

## 端点 [#端点]

| 方法  | 路径                                                                | 说明   | 支持   |
| --- | ----------------------------------------------------------------- | ---- | ---- |
| GET | [`/v1/health`](/docs/api/native/meta/healthCheck)                 | 健康检查 | ● 支持 |
| GET | [`/v1/methods`](/docs/api/native/meta/metaMethodsSearch)          | 搜索方法 | ● 支持 |
| GET | [`/v1/methods/{name}`](/docs/api/native/meta/metaMethodsRetrieve) | 读取方法 | ● 支持 |

## 与官方的差异 [#与官方的差异]

* 本面是平台自描述面，不对应任何第三方官方 API；healthCheck 与方法目录都无需鉴权，healthCheck 返回纯文本 `ok`。
* <a href="/docs/api/native/meta/metaMethodsSearch">搜索方法</a>：非空 q 按方法名、摘要和描述的相关度搜索，词序和大小写不影响匹配；limit 为 1 到 50 的整数，默认 20。不带 q 或 q 全为空白时按方法名排序列出，limit 为 1 到 200 的整数，默认 50；has\_more 为 true 时将 last\_id 原样作为 after\_id 取下一页。搜索时忽略 after\_id。limit 越界返回 400 INVALID\_PARAMS。目录只包含平台方法（praxis.\*），不含会话里的 MCP 工具。
* <a href="/docs/api/native/meta/metaMethodsRetrieve">读取方法</a>：name 取自搜索结果，必须与方法名完全一致。声明不会被截断，字段名和枚举值请直接从中复制。未知名称返回 404 METHOD\_NOT\_FOUND，hint 列出最多三个相近的名称。

Meta 是平台自描述面：`/meta/v1/openapi.yaml` 返回当前环境的完整 OpenAPI 规范，参数与字段以它为准。

错误按 problem+json 格式返回，参见[错误](/docs/api/errors)；额度与响应头参见[限流](/docs/api/rate-limits)。