14.2.1 URI(统一资源标识符)

使用统一资源标识符(URI)[1]指定要访问的资源。URI是URL(统一资源定位器)的泛化,通常将URL视为“Web地址”。URI的作用与在大型组织(如大学)内发送的邮政信件上的地址非常相似:指明收件人、部门和办公地址,从会计部门的Alice与从销售部门的Sally处将得到不同的答复(和不同的数据)。

与邮政信件的地址一样,为了将请求定向到正确的资源,URI有一种非常具体的格式要求,如图14-1所示。

图14-1 URI的格式示例

不是所有的URI部分都是必需的。例如,不一定需要端口、查询或片段。URI的重要部分包括:

1)策略(协议):计算机用于与API通信的“语言”。对于Web服务,通常是https(安全HTTP)。

2)域:提供信息的Web服务器的地址。

3)路径:要访问的Web服务器上的资源标识符。如果试图访问特定文件,则可能是具有扩展名的文件名,但对于Web服务,它通常看起来像文件夹路径!

4)查询:附加参数,包含要访问的资源的详细信息。

域和路径通常用于指定感兴趣的资源的位置。例如,www.domain.com/users可能是为所有用户提供信息的资源标识符。Web服务也可以有“子资源”,可以通过向路径添加额外的部分来访问这些资源。例如,www.domain.com/users/layla可以访问感兴趣的具体资源(“layla”)。

Web API中URI通常分成三部分,如图14-2所示。

图14-2 一个Web API请求URI的剖析 ...

Get 数据科学之编程技术:使用R进行数据清理、分析与可视化 now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.