我认为变化需要时间这是完全合理的。我在上一家公司负责Developer Relations,天啊……我们的API改善花费了超过两年的时间。所以有很多复杂的事情需要考虑(工程团队也讨厌创建一个不能变更的稳定端点!)
不过我确实认为一些小的变化可以随着时间的推移在较短的时间内发生。老实说,我还没有仔细研究你的路由(或者Ruby中的路由)是如何定义的——但我假设一些简单的事情可以相当容易地处理。例如:
我不能代表所有人发言,但我觉得即使你的当前API规范中存在端点——即使没有描述和示例,即使响应模型是流动的——这也是一个很大的胜利。仅仅知道某些内容存在,有时候就已经算一半的胜利了。