Clicked Gallery
「API」とは?
実際の技術ドキュメントでハイライトされた言葉を、Clickedが解説します。
例文
Engineering Notes · AI Systems
The bank exposes account balances through a documented API rather than letting partners touch the database.
読者がドキュメント内の単語をハイライトすると、Clickedが技術用語「API」をやさしく解説しました:
3段階での解説
●○○
Overview
APIとは、アプリケーション・プログラミング・インターフェースの略で、異なるソフトウェア同士が会話しデータをやり取りするための決まりごとのことです。片方が取り決めた形式で尋ね、もう片方が取り決めた形式で答えるので、互いの内部構造を知る必要はありません。ネット上で何かと通信しているものは、ほぼすべてAPIを通しています。
●●○
Detail
APIとは、あるソフトウェアが別のソフトウェアに何かを頼むための公開された手順で、この形式でリクエストを送ればあの形式でレスポンスが返る、という約束になっています。天気サービスなら、都市名を送れば今日の予報を返す、と約束するかもしれません。尋ねる側のアプリは、その予報がどう作られたかを知る必要はまったくなく、どう尋ねるかだけ分かっていれば足ります。この切り離しこそが目的で、両者がそれぞれ独立に変化できるようになるからです。天気サービスはAPIさえ同じままなら、内部を丸ごと作り直しても、利用している全アプリを壊さずに済みます。さらに所有者は、どのリクエストを許すか、誰が使えるか、どのくらいの頻度までかを決めます。その決まりが互換性のない形で変わると古いアプリは動かなくなるため、企業はたいてい既存を書き換えずに新しいバージョンを公開します。現代のAIシステムは常にAPIに頼っていて、天気を調べるのも、カレンダーを読むのも、航空券を予約するのも同じ仕組みです。
●●●
Analogy
レストランのメニューには、何を注文できて注文したら何が来るのかが正確に書かれていて、あなたが厨房を見ることも、シェフに会うことも、レシピを知ることもありません。厨房はオーブンを入れ替えても仕入れ先を変えても、あなたに知らせる必要はなく、それでも注文は通ります。メニューこそが取り決めだからです。載っていないものを頼めば、答えは単に「できません」になります。
AIによる解説には誤りが含まれる場合があります · 専門的な助言ではありません
事実はそのまま、ノリだけ変えて — スラングモード 😎
●○○
Overview
APIは、あるプログラムが別のプログラムに、互いの内部をつつき回さずに物事を頼む方法だ。向こうが望む形で尋ね、約束された答えを受け取り、それ以外には首を突っ込まない。ネット全体がこの取り決めひとつで、毎秒数十億回繰り返しながら支えられている。😎
●●○
Detail
スマホの中のアプリはどれも、自分にできないことを他のプログラムにねだって一日を過ごしている。航空券の価格比較サイトは飛行機を一機も持っていない。各航空会社に今日の運賃を尋ね、返ってきた答えを縫い合わせ、さも自分が賢い仕事をしたかのようにきれいな一覧を差し出しているだけだ。航空会社の側は、どの問い合わせに応じるか、誰に応じるか、何回で応答をやめるかを決めている。誰も自分のデータベースを他人に送りつけたりはしない。公開された形で尋ね、約束された形を受け取り、厨房には入らない。そして形を変えなければならないとき、稼働中のものをいじる者はいない、依存している全アプリを同じ瞬間に壊すからだ。第二版を公開し、初代には静かに引退してもらう、というのが作法だ。😎
●●●
Analogy
自動販売機では、B4を押せばポテトチップスが出てきて、中によじ登って漁ることはどの段階でも許されない。仕入れ先を変えようが、配線を全部やり直そうが、逆さまに補充しようが、B4は依然としてポテトチップスを意味する。存在しないボタンを押せば何も出てこない。チップスも、説明も、返金もなしだ。
AIによる解説には誤りが含まれる場合があります · 専門的な助言ではありません
正式な定義 — 同じ用語の、よくある説明
APIすなわちアプリケーション・プログラミング・インターフェースとは、ソフトウェアシステムが受け付けるリクエストと返却するレスポンスを規定した契約であり、内部実装を露出させずに相互運用を可能にする。この分離により、バージョニングの規律を前提として提供側と利用側が独立に進化でき、認証、認可、レート制限が適用される境界を提供する。
「API」のような言葉を、ブラウザ上でそのままClickedに解説させませんか?PDFにも対応。
Chromeに追加 — 無料無料で50回の解説 · クレジットカード不要