[TIL] API

Eden·2025년 7월 4일

Swift에서의 API는 주로 프로그래머가 시스템, 프레임워크, 또는 외부 서비스와 상호작용할 수 있도록 제공되는 기능 집합을 의미합니다.
API는 함수, 타입, 프로토콜, 클래스 등 다양한 형태로 제공되며, 이를 통해 개발자는 원하는 기능을 손쉽게 구현할 수 있습니다.


1. API란?

  • API는 Application Programming Interface의 약자
  • 특정 기능을 사용할 수 있도록 미리 정의된 함수, 메서드, 타입, 규약의 모음
  • Swift에서는 Apple이 제공하는 다양한 API를 통해 네트워크, UI, 데이터 처리 등을 구현할 수 있음

2. Swift의 주요 API 예시

영역사용 예시
네트워킹URLSession, URLRequest, URLResponse
데이터 관리Codable, UserDefaults, CoreData
UI 구성UIKit, SwiftUI, UIView, UILabel
비동기 처리async/await, DispatchQueue, OperationQueue
시스템 기능NotificationCenter, FileManager, Bundle

3. API 사용 예시: URLSession

let url = URL(string: "https://api.example.com")!
let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
  • URL, URLSession, dataTask 모두 Swift API

4. API 문서 읽는 법

Apple의 공식 Swift API 문서를 통해 각 API의 사용법, 파라미터, 반환값, 예시 등을 확인할 수 있음.

문서에서 자주 보게 되는 형식:

func map<T>(_ transform: (Element) -> T) -> [T]
  • 제네릭(Generic) 함수
  • 클로저를 매개변수로 받음

5. 좋은 API 사용 습관

  • API 문서를 먼저 확인하고 이해한 후 사용
  • 어떤 타입과 반환값이 사용되는지 명확히 인지
  • API가 제공하는 기능을 중복 구현하지 않도록 주의
  • 시스템 버전 별 지원 여부도 확인 필요

결론

Swift API는 iOS/macOS 개발에 있어 가장 기본적이고 강력한 도구입니다.
기본 API들을 잘 이해하고 적절하게 활용하는 것이 고품질의 앱을 만드는 데 매우 중요합니다.

profile
iOS Dev

1개의 댓글

comment-user-thumbnail
2025년 7월 4일

👍🏻👍🏻

답글 달기