各端直连地图能力,会同时丢掉安全与产品边界。
当地图帮从桌面工具扩展到在线制图与多端触点,地理编码、路径、POI 等能力如果各自对接上游,Key 泄露、计费失控、失败语义不一致会同时出现。更危险的是:把 API 控制台塞进普通用户工作台,权限模型与导航心智会一起崩坏。
开发者要的是契约、配额和可预期失败;普通用户要的是完成任务。两者不应共享同一个门户心智。
问题不是“有没有 API 页面”,而是能力如何被正确地产品化。
| 常见做法 | 我重新定义的问题 | 产品价值 |
|---|---|---|
| 把内部已有服务原样暴露 | 开发者任务到底是什么? | 按任务定义能力边界 |
| 控制台与制图站混在同一导航 | 谁是第一用户? | 避免门户错位 |
| 多处各自记账 | 扣减与退款以谁为准? | 单一权威账本 |
| 失败只返回“error” | 超时/重试/退款如何解释? | 可信的商业化底座 |
平台产品的关键取舍。
三层 API 边界
自有应用服务、开发者开放、内部管理分开。未登记接口不得宣传为开放 API。
不是第二个用户门户
开发者五项导航服务契约与治理;普通制图与数据店面留在 Map Studio。
账本权威唯一
用户中心可发起充值,消费与退款权威在真正处理调用与额度扣减的平台侧,避免双账本。
按任务抽象,不按内部实现暴露
参数语义与返回结构面向开发者任务;上游凭据永不下发;失败按契约补偿。
从资格到调用的治理链。
产品层提供目录、文档、控制台与用量可见性;服务层负责鉴权链、计量与上游代理。Web / 桌面 / 未来 AI 工具调用可以共享同一治理模型,但当前对外能力以地理服务为主,不以“大模型 API 网关”对外宣传。
不说“对外开放全部 API”;不把开放平台首页做成第二个 Map Studio。
平台价值如何向业务负责人解释。
可检查的产品证据,而不是漂亮曲线。
接口目录、文档、控制台(Key / 用量 / 调试)等演示页面,可用于对照平台的信息架构。
产品方案明确三层边界、账本权威与“非第二门户”红线。
与 Map Studio、桌面端、用户中心的职责表可核对,而不是口头“中台”。
日/月调用量、活跃 Key、充值消耗比等经营指标待核验,本页不填写、不估算。
平台产品首先是边界产品。
GeoAPI 训练我的是:在商业化压力下仍守住“对谁开放、开放什么、如何计量、失败怎么办”。没有边界的开放,只是把内部复杂度外包给开发者。
若重做,我会更早把开发者成功路径(首调成功时间、鉴权失败可理解率)做成验收指标,并在核对统计口径后分享实际效果。