返回知识库

数据与服务 · 网络与接口

API 端点Endpoint

先看工具会自动补哪段路径,再检查最终请求地址,避免漏路径或重复路径。

让最终地址只出现一次接口路径

默认故意重复填写路径。测试失败后修正,并切换完整端点规则比较。

第 0 步:先打开工具设置 → 模型服务 → 地址配置。模拟服务仅接受 POST https://api.demo.test/v1/messages,不进行真实联网。

你填写https://api.demo.test/v1/messages
+ /messages
最终 POST 地址预览https://api.demo.test/v1/messages/messages

路径尚未匹配,请按配置框规则修正

最近一次请求

尚未测试。先用默认的重复路径发一次,观察回执。

预览随配置改变;最近一次请求保留原地址,防止把“改好了”当成“已验证”。

知识点:端点是请求实际去的地址

基础地址通常包含协议、主机和公共路径,端点还包含本次资源路径;具体拆分由 SDK 或工具决定。这里自动补 /messages,所以基础地址需保留 /v1。换工具后不能照抄同一配置值。

什么时候用,怎么定位

接入模型工具时看到 Base URL、Endpoint 或 404,先读配置框说明,再看最终请求的主机、版本前缀和资源路径。确认 POST 等方法也正确后,发送最小请求。地址匹配不代表认证、权限或模型均有效;真实 404 也可能来自代理或网关。

同一接口的正反例

正例:工具补 /messages,填写 https://api.demo.test/v1,最终路径匹配。

反例:在同一框填写完整地址,工具又补一次,形成 /messages/messages。也不能只填主机,漏掉 /v1。

快速自测

一个工具声明‘地址原样发送’,要调用 /v1/messages,应该填什么?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学