プログラミング言語を学ぶ上で出てくるAPIとは？APIの基礎と使い方について解説！

なぜこの記事を執筆しようと思ったのか

こんにちは。デジタルラボのらいちです。

プログラミング言語を学習する中でAPIを知り、いざ調べてみたものの難しくて挫折しそうになっている方もいるのではないでしょうか。

私もプログラミング言語を学んでいる最中にAPIに出会い、調べたところ、ほとんど理解できずに挫折しかけたことがあります。

その際、「そもそもこんな難しいことをしてまでプログラミング言語を学ぶ意味があるのか？」とも思ってしまうほどに気が滅入ってしまいました。

そこで本記事では、WEBフリーランスを目指す方に同じ経験をしてほしくないため、APIの基礎知識や使い方をわかりやすく解説していきます。

また、APIのニーズやAPIとプログラミング言語の関係から、そもそものAPIやプログラミング言語を学ぶことの重要性もお伝えしていきます。

APIの基礎知識

APIの基礎知識について、下記3つの内容で解説していきます。

そもそもAPIとは

APIは「Application Programming Interface」の頭文字で、ソフトウェア間でデータや処理をやりとりするためのインターフェース（決まりごと）です。

APIによって、異なるプログラミング言語で開発されたシステム同士の連携やデータの受け渡し、既存サービスの機能を扱えるようになります。

こうしたAPIがあることにより、一から機能を作る手間や、よく使われているサービスと連携するなどでより便利なシステムを提供可能になります。

APIの仕組み

APIはクライアントがエンドポイントに対してリクエストを送り、リクエストの内容をもとにサーバーが処理し、レスポンスによって処理の結果を提供するという仕組みです。

用語	説明
クライアント	APIを使用する側のシステムやアプリのこと。いわゆる利用者。
エンドポイント	クライアントがアクセスするための特定のURLのこと。窓口となる場所。
リクエスト	クライアントがサーバーに対しておくる要求（取得、追加、更新、削除など）のこと。
サーバー	APIを提供する側のサーバー（システム）のこと。リクエストをもとに処理をする。
レスポンス	サーバーからクライアントに送られる応答（取得したデータや、処理の結果）のこと。

フードコートで例えると、お客さん（クライアント）が店の注文口（エンドポイント）に対して注文（リクエスト）し、店（サーバー）が料理（結果）を渡すという流れです。

代表的なAPI

APIにはさまざまなものがありますが、代表的な例として以下の3つが挙げられます。

APIという言葉は技術者たちの間で知られますが、技術自体は身近なアプリやWebサービスでなど多くの場面で使用されています。

APIの使い方

APIの使用手順

実際の開発でのAPIの使い方については、以下の5つの手順になります。

上記手順をコードに落とし込み、自身が開発しているシステムに組み込むことで、APIを使ったデータのやりとりや連携が可能です。

サンプルコード

よりAPIの使い方をイメージしていただくため、気象情報を取得できるOpenWeatherMap APIを例に、PHPのサンプルコードを記載します。

<?php
// 1.APIキーの設定（実際には取得したキーを使用します）
$apiKey = "YOUR_API_KEY";
$city = "Tokyo";

// 2.APIリクエストの作成
$endpoint = "https://api.openweathermap.org/data/2.5/weather";
$url = $endpoint . "?q=" . urlencode($city) . "&appid=" . $apiKey . "&units=metric";

// 3.GETリクエストを送信
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
//4.レスポンスの受信
$response = curl_exec($ch);
curl_close($ch);

//5.取得したデータの表示
if ($response) {
    $data = json_decode($response, true);
    if ($data && $data['cod'] == 200) {
        echo "現在の天気: " . $data['weather'][0]['description'] . "<br>";
        echo "気温: " . $data['main']['temp'] . "°C<br>";
    } else {
        echo "天気情報の取得に失敗しました: " . $data['message'] . "<br>";
    }
} else {
    echo "APIリクエストに失敗しました。";
}
?>

上記のコードを実行することで、処理が成功すれば現在の天気と気温を、失敗すれば失敗メッセージを画面に表示されます。

APIへのニーズについて

APIの実用性

APIには以下の5つの観点から実用性があり、世の中のニーズに結び付いています。

こうした実用性から、APIは開発において「単純に便利なもの」ではなく、高度な処理や便利なシステムの開発に「不可欠な存在」となっています。

APIの活用事例

Webサービスやアプリをより便利なものにする、APIの活用事例を3つ挙げます。

これらの事例は身近で便利な機能であり、よく知られたサービスやアプリにおいては標準で搭載されていたりします。

また、こうしたAPIを扱えることで、自身に付加価値を高められるだけでなく、フリーランスとして提案内容や取り扱いサービスも充実できます。

APIとプログラミング言語の関係

プログラミング言語学習を進めていく上で、必ずといって良いほどAPIがでてくるのは、主に3つの関係があるためです。

APIとプログラミング言語を一緒に学ぶことで、より高度なことができるようになり、クライアントの要望に応えられるようになります。

まとめ：プログラミング言語を学ぶ上でかかせないAPIとは？APIの基礎と使い方について解説！

本記事を読んだことにより、APIについてのイメージやAPIとプログラミングを学ぶことの重要性が理解できたかと思います。

項目	説明
APIとは	ソフトウェア間でデータや処理をやりとりするためのインターフェース（決まりごと）。
APIの仕組み	1.クライアントがエンドポイントへリクエストを送る 2.リクエストをもとにサーバーが処理 3.サーバーがレスポンスで処理を返す
APIの使用手順	1.APIキーの取得 2.APIリクエストの作成 3.APIリクエストの送信 4.レスポンスの受信 5.レスポンスデータの利用
APIとプログラミング言語の関係	・APIの呼び出しにプログラミング言語は必須 ・APIがプログラミング言語の機能を拡張 ・APIでプログラミング言語での開発を効率化