REST APIで見かけるvnd.を含んでいるメディアタイプについて

はじめに

REST APIで時々見かけるメディアタイプで、vnd.を含んでいるものがある。 これが何なのかが気になったので調べた。

vnd.はベンダ固有のメディアタイプ

RFC 6838: Media Type Specifications and Registration Procedures によると、vnd.はベンダーの裁量で決めた独自のサブタイプにつけるプレフィックスらしい。 RFC 6838では、このプレフィックスのことをfacetと呼んでるが、文脈からして名前空間に相当する概念と理解した。 サブタイプがvnd.をから始まっていても、なかにはIANAに公式に登録されているメディアタイプもある。

具体例

GitHubのAPIだとapplication/vnd.github+jsonというメディアタイプが利用されている。

参考

• RFC 6838 > 3.2. Vendor Tree

  • https://tools.ietf.org/html/rfc6838#section-3.2

• Media Types

  • https://www.iana.org/assignments/media-types/media-types.xhtml
  • 公式に登録されているメディアタイプで、なかにはvnd.を含むものもある

• GitHubDocs > REST API > Overview > Media types

  • https://docs.github.com/en/rest/overview/media-types