我想与您验证意见。
我必须设计一个网络服务,该服务搜索附属于给定地址周围特定国家/地区的折扣计划的餐馆数据库。
对这样的Web服务的REST调用看起来像http://server/search?country=<countryCode>&language=<languageCode>&address=<address>&zipcode=<zipcode>
问题在于某些国家/地区没有拉链码或在整个国家/地区都没有拉链码。
现在,如果用户为没有邮政编码的国家传递了这样的参数,但是他/她传递了有效的地址,你会怎么做?
有些同事也赞成以下方案 4.简单地说没有结果。并在文档中声明不支持zipcode参数。此外,我们还必须创建一个webservice方法,该方法返回应在用户界面中显示的字段。
您认为最佳选择是什么?为什么?
谢谢!
答案 0 :(得分:0)
即使您不知道邮政编码,OpenStreetMap提名服务器也会返回结果,无论如何您都可以查看结果。如果用户不知道邮政编码但想要找到hist对象怎么办? 无论如何,我会尝试搜索该特定对象,特别是因为您说某些国家/地区部分有邮政编码。
如果您只是简单地返回,则用户不知道出了什么问题,他不会知道该怎么做。
答案 1 :(得分:0)
这取决于用例。 API的用户触发该案例有多容易?这是一个严重的错误,用户真的应该知道如何避免?或者它是不是完全清楚的东西,用户可能知道(或认为他知道)一个正式不应该有的邮政编码?对于用户如何从API检索正确的结果,它是否归结为试验和错误?这是一个糟糕的错误,用户需要了解它并且他需要处理这个问题吗?
如果您将此限制放在API中,请考虑在触发此案例时必须明确记录,API的每个用户都必须阅读并理解该文档,需要明确如何避免问题是,用户需要能够避免这个问题,并且每个用户都必须在他身边正确地实现额外的代码以避免这个问题。用户是否可以轻松知道哪些区域有拉链码而哪些区域没有?
我认为“在你所接受的内容中保持灵活,严格按照你所输出的内容”应用......