2

我是 REST 新手,在为 API 找到合适的 RESTful url 时遇到了一些麻烦。

我有一个 API,给定一个单词,它返回一个带有布尔值的 JSON,指示该单词是否是动词。所以在一个不平静的宇宙中,这个 API 将是一种isVerb方法。我无法为我的 API 的 url 找到合适的 RESTful 名词(因为 REST 中不允许使用动词)。

我已经有一个 API,它给定一个字符串返回该字符串中的动词(实际GET /verbs),所以选项 myapi.com/verbs 是不可能的(并且不会 100% 适合我的问题,因为我没有得到动词,但得到一个布尔值)。

有什么提示吗?非常感谢!

4

2 回答 2

1

如果我理解正确,有两个用例:

  • 1)从字符串中提取动词和

  • 2)测试一个词是否是动词。

以下是我将如何分解问题:

A)你有两个输入,一个字符串和一个单词;但两者都可以抽象为单词数组,

a strings = [‘word1’, ‘word2’, …]

B) 将“/verbs/”视为所有动词的空间

那么问题就变成了通过提供输入(一串单词)从“/verbs/”中的“虚拟”动词空间中获取一组动词。

访问“/verbs/”的 API 可以有两种形式:

A) GET /verbs/?text='word',…</p>

返回:OK,文本子集是动词

返回:未找到

B) 获取 /verbs/{word}/

返回:如果是动词,则可以使用“单词”

返回:未找到

于 2013-07-11T21:21:21.233 回答
0

在我看来'/verbs',路径在这种情况下非常好。但是,如果已经考虑过类似的事情,例如:'/verbsResource', '/versSet', ...

该服务将返回(GET请求):

  • HTTP 200 OK给定字符串是动词时的状态码;
  • HTTP 404 Not Found给定字符串不是动词时的状态码。

所以没有布尔值。

于 2013-07-11T11:49:21.550 回答