Swift学習を始めて「API通信」の学習をしているのですが、「APIって何？」「JSONってなに？」「Codableっとは？」という個人的な疑問を、この記事でまとめました。
0. そもそもAPIとは？
APIは Application Programming Interface の略です。
言葉を分解するとイメージが湧きやすくなります。
- Application：アプリ（LINE、天気アプリなど）
- Programming：プログラム（コード）
- Interface：接点・窓口
👉 つまり 「プログラム同士が情報をやり取りするための専用窓口」 です。
API通信で何をしてるの？
主に使われるのはこの2つです。
| メソッド | イメージ | 内容 |
|---|---|---|
| GET | ちょうだい！ | サーバーに「データをください」とお願いする（例：天気予報の取得） |
| POST | これお願い！ | サーバーに「データを登録して」と送る（例：SNSへの投稿） |
ステータスコード（サーバーからの返事）
200 OK: 成功！404 Not Found: そんな窓口（URL）はありません。
1. なぜAPI通信が必要なの？
現代のアプリは、ほぼすべてAPI通信で成り立っています。
- 天気アプリ：気象庁などのサーバーから最新データを取得
- ECサイト：商品在庫や決済情報をサーバーとやり取り
- SNS：みんなの投稿をサーバーから取ってきたり、自分の投稿を送ったりする
したがって、API通信は避けては通れない必須スキルなのです。
2. JSON（ジェイソン）とは？
APIという窓口でやり取りされる「データの書き方のルール」のことです。
👉 「データをやり取りするための共通言語」 と覚えましょう。
JSONの代表的な3パターン
パターン①：配列（Array）
[] で囲まれている。同じ種類のデータが並んでいる状態。
[
{"name": "Oyazi"},
{"name": "Ohukuro"}
]
パターン②：オブジェクト（Dictionary）
{} で囲まれている。「キー：値」のセット。
{
"user_name": "Oyazi",
"age": 50
}
パターン③：入れ子構造
オブジェクトの中に配列が入っているなど。
{
"users": [
{"name": "Oyazi"},
{"name": "Ohukuro"}
]
}
3. Swiftの「Codable」とは？
ここからは、Swiftを利用する際に、
Codableというプロトコルを理解する必要があります。まず、Codableの役割についてですが、
データを自動変換するプロトコルです・
・Decodable（デコード / 復号）: 「戻す」イメージです。外部データ（JSON文字列など）を、プログラムで扱える形式（Swiftの構造体やクラス）に変換すること。
・Encodable（エンコード / 符号化）: 「形を変える」イメージです。プログラム内のデータ（Swiftの構造体やクラス）を、外部でやり取りしやすい形式（JSON文字列など）に変換すること。
・Codable：上記2つのセット
// JSON形式
{
"id":"WLJJRKJeqjb",
"joke":"I used to work in a shoe recycling shop. It was sole destroying."
}
// Swiftの型として定義しておけば
struct Joke: Codable {
let id: String
let joke: String
}
4.API通信の全体の流れ
アプリがインターネットからデータを取ってきて画面に出すまでの流れになります。
① リクエスト作成（注文書の作成）
「どのURLに」「どんな方法（GET/POST）」で聞くか決めます。
② 通信（非同期処理）🚚
ここが超重要！通信は**「非同期（ひどうき）」**で行われます。
③ データ受け取り（JSON到着）📦
サーバーからデータが届きます。届いた直後はまだ JSON（ただの文字列） です。
④ データ変換（Codableで翻訳）📖
JSONDecoder（JSON→Swiftの型へ） を使って、ただの文字列だったJSONを、Swiftの 「構造体」 に一瞬で変換します。
⑤ 画面表示（UI反映）📱
変換したデータを画面にセットします。最後に「表側（メイン）」に戻して表示させて完了です！
まとめ
API ＝ プログラム同士が情報をやり取りするための専用窓口
JSON ＝ データをやり取りするための共通言語
Codable ＝ Swiftで使いやすくする翻訳機
まだまだ表面しか覚えられていない感覚もありますが、API通信を理解する上で大事と思った３つのポイントでした。