适当的用户代理标头值

时间:2012-06-30 22:57:03

标签: http last.fm

我正在使用HttpBuilder(一个构建在apache的httpclient之上的Groovy HTTP库)向last.fm API发送请求。此API的文档说您应该将user-agent标题设置为“适当的”标题,以减少被阻止的可能性。

知道什么样的价值被认为合适?

2 个答案:

答案 0 :(得分:1)

您的申请名称,包括版本号?

答案 1 :(得分:1)

我为Last.fm工作。 "适当"意味着当我们查看日志时,会以有用的方式识别您的应用。我们何时使用此信息的示例:

  • 调查错误或奇怪的行为;例如,如果您发现了我们无法处理的边缘情况,或意外导致系统异常负载
  • 调查我们认为不合适的行为;我们可能希望通过我们的服务来帮助您的应用程序更好地工作
  • 我们可能会使用此信息来判断使用哪种API方法,频率以及由谁来进行容量规划或获取API生态系统的一般统计信息。

有用的(适当的)用户代理:

  • 告诉我们您的应用程序的名称和版本(最好是在Google上很容易找到的东西!)
  • 告诉我们您的应用程序的具体版本
  • 也可能包含一个可以查找更多内容的网址,例如:您的申请的主页

无用(不合适)用户代理的示例:

  • 与任何流行的网络浏览器相同
  • HTTP客户端库的默认用户代理(例如curl/7.10.6PEAR HTTP_Request

我们发现当您的应用程序是基于浏览器的(例如Javascript或Flash)时,无法更改发送的用户代理,并且不希望您这样做。 (在你的情况下,这不应该是一个问题。)

如果您正在使用第三方Last.fm API库,例如http://www.last.fm/api/downloads中列出的其中一个,那么如果您向User-Agent添加额外信息以识别,我们会更喜欢它你的应用程序,但也留下了库名和版本。这在追踪错误(在我们的服务或客户端库中)时非常有用。