用于返回布尔值的RESTAPI设计

用于返回布尔值的RESTAPI设计,rest,api,api-design,api-gateway,Rest,Api,Api Design,Api Gateway,我正在设计一个RESTAPI,它将接受一个日期,如果该日期是假日或不是布尔格式,则返回该日期。这个的url模式应该是什么 GET <domainname>/holidays?date=<mmddyyy> 应该是这样的还是有更好的方法来设计url 应该是这样的还是有更好的方法来设计url 机器不在乎——URI只是一个标识符。和变量名一样,我们为它们提供了人类可读的拼写,这是为了我们自己的利益 也就是说,如果你使用像 /a7c63fe6-ca28-4f21-9421-c9c

我正在设计一个RESTAPI,它将接受一个日期,如果该日期是假日或不是布尔格式,则返回该日期。这个的url模式应该是什么

GET <domainname>/holidays?date=<mmddyyy>
应该是这样的还是有更好的方法来设计url

应该是这样的还是有更好的方法来设计url

机器不在乎——URI只是一个标识符。和变量名一样,我们为它们提供了人类可读的拼写,这是为了我们自己的利益

也就是说,如果你使用像

/a7c63fe6-ca28-4f21-9421-c9ca3df75658?yyyymmdd
那么一切都应该还可以

使用application/x-www-form-urlencoded键/值对是一个很好的选择,因为HTML表单处理器了解如何构建这些URI,因此可以通过web页面使用/测试它们

?date=<YYYY-MM-DD>
但其他安排并没有错;我们只是有不同的权衡

/holidays/date/<mmddyyy>
这种拼写方式可以让你通过相对的参照物找到有趣的东西

假设您希望客户端创建这些URI,那么您将需要与规范一致的内容

您需要鼓励使用符合ISO-8601的日期拼写