RESTAPI设计:当URL是查询参数时发布或获取

RESTAPI设计:当URL是查询参数时发布或获取,api,rest,post,get,api-design,Api,Rest,Post,Get,Api Design,我正在编写一个API,它将支持一个查询,其中URL将是查询术语,例如:返回包含数据{“URL”的文档的id:http://google.com/directory/directory/document/index.html“} API url应该是这样的/document/getid 根据我的阅读,GET应该用于查询,但当查询可能是很长的URL时,这仍然是最佳选择吗?我正在考虑使用POST,但我希望遵循API设计最佳实践。我决定对URL进行md5哈希,并将其作为字段存储在文档中

我正在编写一个API,它将支持一个查询,其中URL将是查询术语,例如:返回包含数据
{“URL”的文档的id:http://google.com/directory/directory/document/index.html“}

API url应该是这样的
/document/getid


根据我的阅读,GET应该用于查询,但当查询可能是很长的URL时,这仍然是最佳选择吗?我正在考虑使用POST,但我希望遵循API设计最佳实践。

我决定对URL进行md5哈希,并将其作为字段存储在文档中