我很难弄清楚如何最好地定义 REST/HATEOAS 服务的任何选项，因为它们数量巨大，不可能详尽列出可用的资源选项。
特别是，系统的一部分将是用于在大型文本语料库中索引单词使用统计信息的资源 - 类似于 GET http://mysite.org/word_statistics/foobar将有关 foobar 和 URI 的信息返回到使用 foobar 的文档.
但是，我无法提供任何合理的方式来让应用程序发现实际的http://mysite.org/word_statistics/foobar链接 - 规范的方法似乎是提供像http://mysite.org/word_statistics这样的资源这将返回单个 URI 的列表，但在我的情况下，该列表将在 1 GB 左右，因此不太实用。所以我需要给请求的应用程序提供类似http://mysite.org/word_statistics/ {your_query_here} 的东西，但似乎没有 RESTful 方法可以做到这一点。
这应该如何正确完成？
我会遵循许多地方使用的经典搜索模式。
http://example.org/word_statistics - 这将返回所有内容，单词和链接，但您不想返回所有内容，因此您不返回相应的错误代码，可能会返回对您的查询选项的描述做支持。或者您可以返回所有内容，但以页面为单位（一次 10、100、1000 个单词......）。
http://example.org/word_statistics/ {word} -- 给定单词的统计信息。
http://example.org/word_statistics?like=word - 这将返回一个“类似”单词的列表，这可以处理拼写错误和发音相似或其他任何问题。
http://example.org/word_statistics?from_word=word1&to_word=word2 -- 返回一个单词列表，这些单词按字母顺序以 from_word 开头并转到 to_word，但在与原始列表相同的限制和分页约束下.
您还可以执行以下操作：
你可以在这里做各种各样的事情。但是，要点是基本的搜索模式应该很容易满足需求。