我已经采用API蓝图作为我们项目的文档,这很棒。我正在努力解决一件可能很简单但我无法概念化的事情: 如何确保连接到共享数据库的API端点始终提供一组已知数据?
我可以通过这种方式将其可视化:确保我的HTTP操作的顺序全部按顺序排列,例如(伪代码,而不是实际的api蓝图语法):
POST /user
{user_name: 'foo'}
返回{id:1}
GET /user/1
返回{user: 'foo'}
PUT /user/1
{user_name: 'bar'}
返回{id: 1}
DELETE /user/1
返回{delete: 'success'}
有没有其他人解决过这个问题,不幸的是我无法确保API所连接的后端数据库的状态,这就是我面临这些不一致问题的原因。我们的一些团队已经编写了满足GET部分的文档规范,因为他们手动输入记录(例如,他们还没有创建POST逻辑)但是一旦我们切换后端DB GET user / 1就不会总是返回'foo'。希望这是有道理的,如果我为了清晰起见而编辑我的问题,请告诉我。