iOS Networking

Priority: P0

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

• ❌ UI updates from background thread — always dispatch to @MainActor or main queue
• ❌ Manual JSONSerialization — use Codable and JSONDecoder
• ❌ No timeout set — always set a reasonable timeoutInterval (30s default)

References

• Native & Alamofire Implementation