指南

免费 Mock

把 /gw/ 换成 /mock/,立刻拿到端点的示例响应:不需要 key、不收费,也不会调用提供者。在充值之前就能把 agent 搭好并测通。

ANYhttps://gw.pikeway.ai/mock/<slug>/<path>

试一试

1

拿一个网关 URL

Mock URL 和真实 URL 完全对应:相同的 API slug、路径、方法、查询参数和请求体,只换前缀。

2

把 `/gw/` 换成 `/mock/`

bash

# Live (needs a key, charged on success)
curl "https://gw.pikeway.ai/gw/dexscreener/latest/dex/search?q=WBTC" -H "Authorization: Bearer $PIKEWAY_KEY"

# Mock (no key, free, upstream never called)
curl -i "https://gw.pikeway.ai/mock/dexscreener/latest/dex/search?q=WBTC"
# X-Pikeway-Mock: true
# X-Pikeway-Cost: 0

3

切换到真实调用

解析和流程都跑通后,把前缀改回 /gw/ 并带上 key。见 Key、余额与计费。

返回内容

网关按方法和路径匹配到端点,以 JSON 返回它登记的 2xx 示例:优先是提供者发布的示例;如果提供者开启了自动示例,则是首次成功实时调用时捕获的响应;否则根据响应 schema 生成样例。

响应头

X-Pikeway-Mocktrue

标记这是示例数据,方便代码区分真实数据。

X-Pikeway-Cost0

Mock 永远免费。

Mock 数据是静态的,查询参数和请求体不会改变返回内容,不要拿它做决策;它只用于把解析和控制流程接通。

限制

每个 IP 每分钟 30 次,超过返回 429。
还没有示例的端点返回 404 并附说明。提供者发布示例后,或(开启自动示例时)首次成功实时调用后,就会有示例。
私有 API 没有 Mock。AI 模型和 WebSocket 流不提供 Mock。