API Hub

调用之前,先了解需要准备什么。

每个版本的认证方式、规范文档位置和测量结果都会记录在版本下方,并注明信息来源和时间。

三张浅蓝色厚纸交叠,角落各有一圈空白方形压纹,底下露出深灰蓝色纸面。

版本信息

认证方式和规范文档,按版本分别记录。

同一 API 的不同版本可能使用不同认证方式。因此这些事实会关联到具体版本,并逐项注明出处。

  • 认证方式

    免认证、API 密钥或用户授权,都会按版本记录。新版本更改认证方式,不会改动旧版本的记录。

  • 规范文档

    条目会记录规范文档的位置、提供者和确认日期。

  • 测量结果

    测量结果必须附上指标、方法、条件、单位和时间。

  • 出处

    每条事实都会注明来自提供者、公开数据导入还是社区测量。导入的数据会附上来源和授权链接。

测量和评分不是一回事。评分反映大家的看法;测量说明在什么条件下测得了什么。

测量

查看一项测量,先了解这五条信息。

先查看指标、方法、条件、单位和时间;进行比较时,也要核对结果、对象和范围。

  • 指标

    测量的内容。

  • 方法

    采用的测量方法。

  • 条件

    测量时的条件。

  • 单位

    数值使用的单位。

  • 时间

    测量日期。旧结果会保留原日期。

同一指标的结果会形成历史记录,也可以与其他 API 放在同一张比较表中。

缺少的数据

未知、零和不适用,是三种不同的结果。

没有测量过就是未知,不会写成零;不适用的指标也不会被视为缺少数据。缺失数据不会转变成误导性的评分。

了解认证方式后,再开始集成。

使用同一个账号查找 API、关注版本更新,也把集成经验分享给其他人。