ios-networking

name	ios-networking
description	Build API clients with URLSession, Alamofire, and Codable. Use when implementing URLSession networking, Alamofire, or API clients in iOS.
metadata	{"triggers":{"files":["**/*Service.swift","**/*API.swift","**/*Client.swift"],"keywords":["URLSession","Alamofire","Moya","URLRequest","URLComponents","Codable"]}}

iOS Networking

Priority: P0 (CRITICAL)

Implementation Workflow

1. Choose networking layer — Use native URLSession with async/await for simple apps; Alamofire for production APIs with interceptors.
2. Build URLs safely — Use URLComponents and URLQueryItem; never use string interpolation for URL parameters.
3. Decode with Codable — Use Codable for all JSON mapping. Prefer snake_case key decoding strategies.
4. Add auth interceptor — Use RequestInterceptor to inject Authorization: Bearer <token> on all requests.
5. Handle token refresh — On 401, use RequestInterceptor.onRetry to call refreshToken() and retry.
6. Pin certificates — Use ServerTrustManager or TrustKit for production-grade security.

See URLSession and Alamofire implementation examples

Anti-Patterns

• No Background UI Updates: Always dispatch to @MainActor or main queue
• No Manual JSONSerialization: Use Codable and JSONDecoder
• No Missing Timeouts: Set reasonable timeoutInterval (30s default)

References

• Native & Alamofire Implementation