Skip to Content
Web API: The Good Parts
book

Web API: The Good Parts

by 水野 貴明
November 2014
Intermediate to advanced
224 pages
3h 22m
Japanese
O'Reilly Japan, Inc.
Content preview from Web API: The Good Parts

1章Web APIとは何か

本書はタイトルにもあるように、Web APIについて述べた書籍です。Web APIをどのように設計、運用すればより効果的なのか、ありがちな罠、落とし穴を避けるにはどういう点に気をつけなければいけないのか、ということを考えていくことが本書の目的となっています。とはいっても、「Web API」という定義は曖昧ですから、まずはじめに本書がターゲットとするWeb APIとはどんなものであるのか、ということをきちんと定義しておくことにします。

本書で言うところのWeb APIとは「HTTPプロトコルを利用してネットワーク越しに呼び出すAPI」です。APIとは“Application Programming Interface”の略で、ソフトウェアコンポーネントの外部インターフェイス、つまりは機能はわかってるけれどもその中身の実際の動作は詳しくわからない(知らなくてもよい)機能のカタマリを、外部から呼び出すための仕様のことを指します。プロトコルとしてHTTPを使うため、そのエンドポイントはURIによって指定されることになります。

定義を厳密にしようとするとやや複雑な言い回しになってしまいますが、簡単に言えばあるURIにアクセスすることで、サーバ側の情報を書き換えたり、サーバ側に置かれた情報を取得できたりすることができるウェブシステムで、プログラムからアクセスしてそのデータを機械的に利用するためのものです。

「機械的に」と書いたのは、これがブラウザを使って人間が直接アクセスすることを目的としたURIではないことを意味しています。たとえばTwitterはWeb APIを公開しており、これがTwitter普及の一因を作ったと言われていますが、特定のユーザーのタイムラインを取得するAPIは以下のようになっています。 ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

Principles of Web API Design: Delivering Value with APIs and Microservices

Principles of Web API Design: Delivering Value with APIs and Microservices

James Higginbotham
API Design Patterns

API Design Patterns

John J. Geewax
Designing APIs with Swagger and OpenAPI

Designing APIs with Swagger and OpenAPI

Lukas Rosenstock, Joshua Ponelat
Mastering API Architecture

Mastering API Architecture

James Gough, Daniel Bryant, Matthew Auburn

Publisher Resources

ISBN: 9784873116860Other