Metrist 的第三方 API 设置说明

Metrist 支持第三方 API 发送 Twitter，但您需要正确的配置后才可以使用。

设置第三方 API

在插件初次安装或者点击相应的设置按钮后，会弹出设置页面。在此页面中，您可以设置您的第三方 API 地址，例如原 Twitter 获取 timeline 地址为：

http://twitter.com/statuses/user_timeline/feelinglucky.json

同时您的第三方对应的 API 地址为

http://foo.com/api/statuses/user_timeline/feelinglucky.json

那么，您在设置框中填入

http://foo.com/api

即可，注意不要在最后面加“/”，因为 Metrist 会自动加上它。

Metrist 的数据获取流程

首先，在您初次输入您的 Twitter 用户名和密码后，Metrist 会验证您帐户的有效性，如果登录不通过，则会再次弹出设置页面（此时，右上角的 Metrist 小图标对应有个“！”）。

在登录成功以后（已登录后第二次不会重复验证），Metrist 会依次获取如下信息

• Timeline
• Firends Timeline
• Replies
• Directs

在获取任何个项目失败时，剩余的项目不会获取（处于网络情况考虑）。

附，Metrist 图标各种状态说明

• “?”，正在初始化，或者获取 Tweets 数目未知
• “!”，获取数据失败或者超时
• “2”，有两条未读 Tweets

获取 Metrist 的调试信息

如果使用您的第三方 API 还是连接不上，那么首先要得知 API 地址以及返回的数据是否正确。那么我需要了解 Metrist 如何向您的 API 请求数据。

如上图，点击右上角的“Extensions”，会弹出插件页面

点击打开“开发模式（Developer mode）”

然后，在 Metrist 插件下会有个 background.html，点击会弹开调试窗口。

在调试窗口中，点击左下角的显示控制台，从此控制台您可以得知 Metrist 请求的 API 地址以及返回的信息。

“为何还是连接不上？”

根据控制台得知请求地址以及返回信息，基本可以 Metrist 获取数据情况，以便您可以做出相应的调整。但如果还为连接成功，则需要考虑下面的情况：

访问情况

Twitter 有针对单个 IP 地址的 API 请求次数的限制，如果您使用公共服务器（如 Appspot）或者公用的第三方 API，而且没有加入 Twitter 的白名单，尤其需要注意您的 API 是否超出 Twitter 的 API 请求次数限制。

延长超时时间

Metrist 对请求有超时限制（在设置面板中有相应的设置），如果您的网络情况不理想或者访问第三方 API 非常缓慢，则可以考虑延长请求 API 的超时时间。通常，HTTPS 对比 HTTP 连接需要额外更多的时间。

更换其他 API

如果条件允许，您可以尝试更换别的第三方 API 再重试，确定是否是此第三方 API 本身的问题。

提交问题

在了解上述情况后，还未解决该问题，很不幸这可能是 Metrist 的 Bug，您可以在这里提交您的问题（请务必说明详细情况），您提交的问题将有助于改善 Metrist 的质量。

附录

常用网络类型以及第三方 API 测试情况 （截至 2009-11-23）：

HTTPS/Twitter

可正常访问，但需要适当延长超时时间

HTTP/Twip

可正常访问，但需要考虑请求次数被限制的情况

Birdnest

可正常访问，但需要考虑请求次数被限制的情况

Appspot

可正常访问，但需要考虑请求次数被限制的情况

VPN

根据 @suyuan19 提供的情况，他通过 VPN 后无法使用，但不排除个例需要额外的测试。

需要提供更多的测试案例，欢迎提供