Swift アプリ開発とバックエンド連携｜API通信の基本

1. API通信とは？

1. API通信とは？

API通信とは、アプリとサーバーがデータをやり取りする仕組みです。APIは「Application Programming Interface（アプリケーション・プログラミング・インターフェース）」の略で、アプリと外部のサービスをつなぐ「窓口」のような役割を持っています。

例えば、飲食店で「店員さんに料理を注文する」と考えてみましょう。お客さん（アプリ）は料理（データ）が欲しいですが、直接キッチン（サーバー）に入れません。そこで店員さん（API）が注文を受け取り、キッチンに伝えて料理を持ってきます。これがAPI通信のイメージです。

2. バックエンド連携の流れ

2. バックエンド連携の流れ

Swiftで作ったiOSアプリがバックエンドと連携するときの流れは次のようになります。

1. アプリが「データをください」とサーバーにリクエストを送る
2. サーバーがリクエストを処理してデータを準備する
3. サーバーがレスポンス（返事）を返す
4. アプリがレスポンスを受け取り、画面に表示する

このやり取りの中で使われるのがHTTP通信です。ウェブサイトを見るときと同じ仕組みを使って、アプリもデータを取りに行きます。

3. SwiftでAPI通信をする方法

3. SwiftでAPI通信をする方法

Swiftでは、URLSessionというクラスを使ってAPI通信を行います。これはAppleが用意してくれている仕組みで、初心者でも簡単に使えます。

import Foundation

let url = URL(string: "https://jsonplaceholder.typicode.com/todos/1")!

let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let data = data {
        if let jsonString = String(data: data, encoding: .utf8) {
            print(jsonString)
        }
    }
}
task.resume()

この例では、サンプルのAPIにアクセスしてJSON形式のデータを取得しています。JSON（ジェイソン）は「データの入れ物」のような形式で、サーバーとアプリの間でよく使われます。

4. JSONデータを扱う

4. JSONデータを扱う

APIから返ってくるデータはJSON形式が多いです。JSONは「キーと値」の組み合わせでデータを整理しています。例えば次のような形です。

{
    "id": 1,
    "title": "買い物に行く",
    "completed": false
}

SwiftでJSONを扱うときは、Codableという仕組みを使うと便利です。

struct Todo: Codable {
    let id: Int
    let title: String
    let completed: Bool
}

let url = URL(string: "https://jsonplaceholder.typicode.com/todos/1")!

let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let data = data {
        let decoder = JSONDecoder()
        if let todo = try? decoder.decode(Todo.self, from: data) {
            print(todo.title)
        }
    }
}
task.resume()

このように構造体を定義しておくと、JSONのデータを自動で変換して扱いやすくなります。

5. POSTリクエストでデータを送る

5. POSTリクエストでデータを送る

API通信はデータを受け取るだけでなく、送ることもできます。例えば「新しいユーザー登録」や「コメントの投稿」などは、サーバーにデータを送る処理です。

let url = URL(string: "https://jsonplaceholder.typicode.com/posts")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")

let parameters = ["title": "テスト", "body": "Swiftから送信", "userId": 1] as [String : Any]
request.httpBody = try? JSONSerialization.data(withJSONObject: parameters)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        let responseString = String(data: data, encoding: .utf8)
        print(responseString ?? "")
    }
}
task.resume()

ここではPOSTリクエストを使ってデータを送っています。API通信ではGET（データを取得）とPOST（データを送信）がよく使われる基本です。

6. API通信で気をつけるポイント

6. API通信で気をつけるポイント

初心者がAPI通信を行うときに気をつけたいポイントを整理しておきましょう。

• インターネット接続がないと通信できないので、エラー処理を入れる
• サーバーが返すデータが正しいかどうか確認する
• 大量のデータを一度に扱うとアプリが重くなるので工夫する
• セキュリティのためにHTTPS（暗号化された通信）を使う

これらを守るだけでも、アプリの安定性と安全性がぐっと高まります。