URL, URIの違いやプロトコルなどの関連用語についてまとめてみた

背景

かつて"URL"は「Web上の住所に当たるもの」という認識をしていました。 API開発をするようになり、いつからか"URI"という表現を見るようになりました。

なぜAPI開発の文脈ではURIがしばしば使われるのか？何が違うのか？

それらを噛み砕くために、関連用語も含めてまとめてみました。

（しかしながら、概念的な話で難しい＆明確な答えがないものが多く、まとまりきっていない点もあります...）

URL, URI, URLとは

URIにURLやURNが含まれる、という理解をしました。

用語	説明
URL(Uniform Resource Localtr)	場所を表す書き方のルールファイルの住所のようなもの
URN(Uniform Resource Name)	名前を永続的に識別する書き方のルールこれ単体でアクセスできるとは限らない
URI(Uniform Resource Indicator	名前や場所を識別する書き方のルールの総称

cf:

具体例

アドレスはURL
メールアドレスもURL

どちらも「アドレス」= 場所を表しているのでURLになる、と。

cf. URL と URI の違い - Qiita

URI, リソース, エンドポイントとは

オブジェクトやエンティティを表すリソースの識別子がURIであり、HTTPメソッドでリソースを操作する、というイメージでしょうか。

用語	説明
リソース	オブジェクトまたはエンティティ
URI	リソースを表す一意の識別子
エンドポイント	HTTPメソッドとURIの組み合わせ

cf:

*SPA開発におけるWeb API設計入門（エンドポイント編） | Hypertext Candy * Web API 設計の基本を学ぶ（APIエンドポイント） - Qiita

URIを分解する

ここからはだいぶ具体的な話になります。

概要

foo://example.com:8042/over/there?name=ferret#nose というURIを例にします。

この時、それぞれ以下のような名前となります。

foo # scheme(スキーム)
: # 区切り文字
//example.com:8042 # authority
 - example.com # host
 - :8042 # port // 省略すると80番
/over/there # path
?name=ferret&owner=john # query
#nose # fragment

cf. Uniform Resource Identifier (URI): 一般的構文