Сетевой слой

Cache-Control задаёт свежесть — как долго ответ можно переиспользовать до устаревания. ETag — метка версии, которую клиент возвращает в If-None-Match, чтобы сервер ответил 304 Not Modified без тела, когда ничего не изменилось. URLCache делает это для URLSession, переиспользуя свежее и ревалидируя по заголовкам.

Data task возвращают ответ в памяти, upload task отправляют тело или файл с прогрессом, а download task пишут в возобновляемый временный файл. Конфигурация default сохраняет кэш и cookie, ephemeral ничего не хранит на диске, а background продолжает передачи, пока приложение приостановлено.

App Transport Security требует HTTPS с TLS 1.2+, forward secrecy и сильными шифрами, по умолчанию блокируя открытый HTTP. Certificate pinning доверяет только конкретному сертификату сервера или его public key, а не любому от CA. Риск: ротация запиненного сертификата оставляет приложение без связи, пока оно не выпустит обновление.

Swift синтезирует init(from:) и encode(to:), когда каждое хранимое свойство само Codable. Добавьте enum CodingKeys, чтобы переименовать или пропустить ключи, когда имена в JSON отличаются, и пишите init(from:) вручную, когда декодированию нужны преобразование, умолчания или форма, которую не вывести.

Поставьте значение Endpoint (path, method, query, body) за протокол Requesting. Конкретный клиент строит URLRequest, запускает URLSession, декодирует через один общий Codable-decoder и сводит ошибки транспорта, статуса и декодирования в единый типизированный error. Фичи зависят от протокола, поэтому тест внедряет фейк и проверяет запрос и модель без сети.

Повторяйте только идемпотентные запросы (GET, PUT, DELETE) и временные сбои — тайм-ауты, 503, 429 — но не 400 и не неидемпотентный POST. Отступайте экспоненциально с ограничением попыток и добавляйте случайный jitter, чтобы клиенты не повторяли синхронно и не забивали восстанавливающийся сервер. Уважайте заголовок Retry-After, если он есть.

Опишите протокол Transport — func data(for: URLRequest) async throws -> (Data, URLResponse) — и сделайте URLSession его соответствием. Функция строит запрос, делает await транспорта, проверяет статус и декодирует через JSONDecoder. В проде внедряется реальный URLSession; в тесте — заглушка с готовыми данными, поэтому тест идёт офлайн.

Пропускайте 401 через один actor, владеющий токеном. Первый 401 запускает единственный рефреш; остальные четверо приостанавливаются и ставят continuation в очередь, а не запускают собственный. При успехе повторите отложенные запросы с новым токеном; при провале завалите их все и заставьте перелогиниться. Пришедший во время рефреша запрос встаёт в то же ожидание.

Возьмите background URLSession и upload task на основе файла, а не Data в памяти, чтобы передачей владела ОС, пока приложение приостановлено. Возобновляемый или chunked-протокол продолжает передачу с середины файла при обрыве. По завершении система перезапускает приложение и зовёт delegate; переподключитесь, пересоздав сессию с тем же идентификатором.

Наблюдайте пути через NWPathMonitor — онлайн/офлайн и constrained — а не пингуя хост. Сохраняйте каждую отложенную мутацию в дисковую очередь, чтобы краш ничего не терял. На satisfied-пути разгребайте её по порядку, повторяя сбои с backoff и дедуплицируя по client-assigned id. Конфликты решает политика — last-write-wins, server-wins или слияние.

REST прост и кэшируется по HTTP, но склонен тянуть лишнее и требует явного версионирования. GraphQL берёт ровно нужные поля, убивая недо- и переизбыточную выборку и упрощая эволюцию, но HTTP-кэширование усложняется. gRPC/protobuf даёт самые компактные нагрузки, кодоген и стриминг, но теряет HTTP-кэш. Здесь я бы взял GraphQL, а gRPC — если решает размер нагрузки.

Выставьте маленькую публичную поверхность из протоколов, а конкретные типы держите внутренними, чтобы менять их, не трогая вызывающих. Версионируйте по semantic versioning — аддитивные меняют minor, ломающие — major — и депрекейтите через availability-аннотации. Модули расширяют поведение упорядоченной цепочкой interceptor'ов с областью на клиента, чтобы один модуль не трогал трафик другого.