Отметим: когда при конвертации 10 000 USD в RUB из-за округления Float пропадает 47 рублей — пользователь видит баг, а не фичу. Технически конвертер прост, но ошибки в арифметике, кэше или API-интеграции превращают его в источник жалоб. Разберём, как построить надёжный модуль с нуля: от выбора провайдера курсов до обработки краевых случаев с локалями и rounding. Наша команда — 7 лет в мобильной разработке, 30+ реализованных fintech-модулей. Мы знаем все подводные камни и гарантируем точность на всех устройствах.
Как выбрать API для курсов валют?
Выбор API зависит от требований к частоте обновления и набору валют. Сравним популярные варианты:
| API |
Бесплатный план |
Обновление |
Особенности |
| ExchangeRate-API |
1500 запросов/мес |
Ежедневно |
Простой REST, 170+ валют |
| Open Exchange Rates |
1000 запросов/мес |
Ежечасно |
Исторические данные |
| Fixer.io |
100 запросов/мес |
Ежечасно |
EUR как базовая валюта |
| ЦБ РФ XML |
Бесплатно |
Ежедневно |
Официальные курсы для RUB |
| НБ РБ |
Бесплатно |
Ежедневно |
Официальные курсы для BYN |
ExchangeRate-API в 3 раза дешевле Fixer.io на среднем объёме запросов. Для большинства приложений достаточно ежедневного обновления — ЦБ РФ отдаёт XML по адресу https://www.cbr.ru/scripts/XML_daily.asp, парсим через XMLParser на iOS или XmlPullParser на Android. Обратите внимание: ЦБ РФ использует кодировку windows-1251 и может менять формат ответа. Мы всегда применяем автоматические тесты регрессии на sandbox-данных и предусматриваем fallback на другой провайдер.
Почему Decimal, а не Float?
Никогда не используйте Float или Double для финансовых расчётов. Разница в копейках при конвертации крупных сумм будет заметна. Сравните точность:
| Тип |
Точность |
Пример ошибки |
| Float/Double |
~7-15 цифр |
0.1 + 0.2 = 0.30000000000000004 |
| Decimal (iOS) / BigDecimal (Android) |
28-38 цифр |
0.1 + 0.2 = 0.3 |
Для 1 000 000 USD расхождение в 0.01% даст ошибку в 100 USD. На iOS используем Decimal, на Android — BigDecimal. Они гарантируют точность до копейки и корректное округление по правилам финансовой математики. Подробнее о Decimal data type.
Офлайн-кэширование и фоновая синхронизация
Курсы сохраняем локально: Core Data / Room для возможности работы офлайн с последними известными значениями. Показываем метку времени последнего обновления — пользователь должен понимать, насколько актуальны данные. Для самых свежих курсов используем фоновую синхронизацию через WorkManager (Android) или BGTaskScheduler (iOS). На одном проекте мы реализовали TTL в 30 минут и кэш на 7 дней. Пользователь всегда видит актуальность данных, а при отсутствии сети — предупреждение.
Пример кода парсинга ЦБ РФ на Swift
import Foundation
struct CurrencyRate: Decodable {
let code: String
let nominal: Int
let value: Decimal
}
class CBRParser: NSObject, XMLParserDelegate {
private var rates: [CurrencyRate] = []
private var currentElement = ""
private var currentCode = ""
private var currentNominal = ""
private var currentValue = ""
func parse(data: Data) -> [CurrencyRate] {
let parser = XMLParser(data: data)
parser.delegate = self
parser.parse()
return rates
}
func parser(_ parser: XMLParser, didStartElement elementName: String, namespaceURI: String?, qualifiedName qName: String?, attributes attributeDict: [String : String] = [:]) {
currentElement = elementName
}
func parser(_ parser: XMLParser, foundCharacters string: String) {
switch currentElement {
case "CharCode": currentCode += string
case "Nominal": currentNominal += string
case "Value": currentValue += string
default: break
}
}
func parser(_ parser: XMLParser, didEndElement elementName: String, namespaceURI: String?, qualifiedName qName: String?) {
if elementName == "Valute" {
let rate = CurrencyRate(code: currentCode.trimmingCharacters(in: .whitespacesAndNewlines),
nominal: Int(currentNominal.trimmingCharacters(in: .whitespacesAndNewlines)) ?? 1,
value: Decimal(string: currentValue.trimmingCharacters(in: .whitespacesAndNewlines).replacingOccurrences(of: ",", with: ".")) ?? 0)
rates.append(rate)
currentCode = ""
currentNominal = ""
currentValue = ""
}
}
}
Процесс работы над конвертером
- Аналитика — сбор требований (валюты, точность, частота обновления) и выбор API.
- Проектирование — архитектура: слой данных, репозиторий, кэш, view model (MVVM + Clean Architecture).
- Реализация — кодовая база с юнит-тестами (20+ тестов на арифметику и кэширование).
- Интеграция — подключение выбранного API, обработка ошибок (нет сети, лимит запросов, смена формата).
- Тестирование — на 10 реальных устройствах с разными локалями и регионами.
- Деплой — публикация в App Store / Google Play с прохождением ревью.
Что входит в работу
- Исходный код на Swift (iOS) или Kotlin (Android) с комментариями.
- Документация API и инструкция по обновлению ключей.
- Настроенная схема кэширования (локальная БД) с TTL.
- Отчёт о тестировании с покрытием кода >80%.
- Поддержка в течение 2 недель после сдачи.
Сроки и стоимость
Срок реализации: от 3 до 7 рабочих дней. Стоимость фиксируется после согласования ТЗ и не меняется. Экономия на времени разработки до 30% при заказе комплексного решения. Свяжитесь с нами для оценки вашего проекта — мы подберём оптимальное решение под ваш бюджет.
Типичные ошибки при разработке конвертера
- Игнорирование Decimal: 95% багов в конвертерах связаны с округлением.
- Отсутствие обработки локали: на немецкой локали запятая — разделитель тысяч, что ломает парсинг.
- Жёсткая привязка к одному API: всегда предусматривайте возможность смены провайдера курсов.
- Нет проверки срока кэша: пользователь видит курс недельной давности без предупреждения.
Закажите разработку конвертера валют под ключ — получите готовое решение с исходниками и поддержкой.
Интеграция API в мобильное приложение: с чего начать
Запрос уходит, ответ не приходит, timeout — 30 секунд. Пользователь смотрит на спиннер. Сети нет — мобильная карта в метро. Или сеть есть, но сервер вернул 200 с HTML-страницей ошибки вместо JSON — и приложение крашит при JSONDecoder.decode(). Мы видим такие кейсы на каждом втором проекте. Поэтому интеграция API в мобильное приложение — это не просто вызов endpoint'а, а проектирование надёжного сетевого слоя: обработка ошибок, кэширование, offline-режим, certificate pinning. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.
Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.
Как выбрать протокол для интеграции API?
| Протокол |
Размер ответа |
Скорость парсинга |
Кэширование |
Подходит для |
| REST |
большой (фиксированная структура) |
среднее |
HTTP-кеш + локальное |
CRUD, типовые экраны |
| GraphQL |
минимальный (только нужные поля) |
среднее (нормализованный кеш) |
in-memory кеш (Apollo) |
сложные UI с разными выборками |
| gRPC |
минимальный (protobuf) |
высокое |
на уровне стримов |
high-load, real-time, IoT |
| WebSocket |
— (бинарный/текст) |
— |
вручную |
чаты, котировки, синхронизация |
REST остаётся стандартом для большинства проектов. Но когда на экране профиля нужно 5 полей из 40, GraphQL исключает over-fetching и сокращает трафик на 30–60%. gRPC оправдан при тысячах запросов в минуту (trading, IoT) — бинарная сериализация в 3–5 раз быстрее JSON. WebSocket — единственный выбор для real-time без polling (сообщения, уведомления).
Пример из практики: для финтех-приложения мы заменили REST (40 полей) на GraphQL — размер ответа сократился с 12 КБ до 2,5 КБ, время рендера экрана упало на 70%. Экономия трафика составила около 15 000 ₽ в месяц при 100 000 активных пользователей.
Как обеспечить надёжность соединения и offline-first
Пользователи теряют сеть в метро, лифте, тоннеле. Мобильное приложение обязано работать без интернета — хотя бы в read-only режиме. Мы внедряем паттерн offline-first:
- При открытии экрана сначала показываем данные из локального кеша (Core Data / Room).
- Параллельно выполняем сетевой запрос, обновляем UI после ответа.
- Если сеть недоступна — показываем кешированные данные и метку «нет соединения».
- При восстановлении сети автоматически синхронизируем изменения.
Для кэширования HTTP-ответов используем URLCache (iOS) и OkHttp Cache (Android) с поддержкой Cache-Control. Для структурированных данных — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback отслеживают состояние сети и триггерят обновление.
REST и выбор клиентской библиотеки
Alamofire (iOS) — де-факто стандарт для Swift-проектов. Поверх URLSession добавляет request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() с .validate() возвращает ошибку для любого статус-кода вне 200–299. Без .validate() Alamofire считает 404 и 500 успешными ответами. С Swift Concurrency — async-версия через serializingDecodable.
Retrofit (Android) — аннотационный HTTP-клиент поверх OkHttp. Интерфейс с аннотациями компилируется в реализацию. @GET, @POST, @Path, @Query, @Body — декларативное описание API. OkHttp под капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логирование в debug-сборке. Authenticator — автоматический refresh токена при 401.
Ktor (KMM/Flutter) — мультиплатформенный HTTP-клиент. На iOS работает через Darwin engine (URLSession), на Android — через OkHttp. Единый код для обеих платформ при KMM-архитектуре.
GraphQL: когда REST не справляется
REST возвращает фиксированную структуру. Экран профиля требует name, avatar, email — сервер отдаёт 40 полей. Over-fetching. GraphQL решает это: клиент запрашивает ровно нужные поля. Это критично для мобайла, где трафик и время парсинга — реальные ограничения. Apollo iOS и Apollo Kotlin генерируют типизированные классы по схеме: schema.graphql + query-файлы → строгие типы на этапе компиляции. Subscriptions через WebSocket — real-time без polling. Ограничение: GraphQL сложнее кешировать на уровне HTTP. Apollo использует нормализованный in-memory кеш InMemoryNormalizedCache — запросы с пересекающимися данными обновляют кеш без дублирования. Apollo GraphQL Documentation
WebSocket: real-time без лишнего трафика
Polling (setInterval каждые 5 секунд) — трата батареи и трафика. WebSocket — постоянное двунаправленное соединение. iOS: URLSessionWebSocketTask (нативный, iOS 13+). Android: OkHttp WebSocket. Обязательная обработка reconnect: при onFailure — экспоненциальный backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надстройка с автоматическим reconnect, но для новых проектов предпочтительнее нативный WebSocket (меньше зависимостей).
gRPC: для высоконагруженных сервисов
gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.
Certificate Pinning и безопасность
Корпоративный proxy может перехватить HTTPS через подмену сертификата. Certificate pinning предотвращает это: приложение принимает только конкретный сертификат или публичный ключ. Alamofire: ServerTrustManager с PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner с SHA-256 хешем. Операционная сложность: при ротации сертификата старые версии приложения перестают работать. Решение — pinning на публичный ключ CA или поддержка нескольких пинов с grace period. Подробнее о certificate pinning на Wikipedia
Что входит в работу
| Этап |
Длительность |
Результат |
| Анализ API и requirements |
1–2 дня |
Спецификация эндпоинтов, выбор протокола, схема кэширования |
| Реализация сетевого слоя |
3–5 дней |
Клиентская библиотека, обработка ошибок, retry, pinning |
| Offline-режим и кеширование |
2–3 дня |
Локальное хранилище, offline-first паттерн |
| Интеграция и тестирование |
2–3 дня |
Юнит-тесты (URLProtocol/OkHttp MockWebServer), UI-тесты |
| Деплой и документация |
1 день |
CI/CD, доступы к сторам, README для команды |
Мы передаём: исходный код сетевого слоя, документацию по используемым библиотекам, инструкцию по ротации сертификатов, поддержку в течение 2 недель после сдачи.
Сроки и стоимость
Реализация сетевого слоя с REST, retry, кэшированием и offline-режимом — 1–2 недели. Добавление GraphQL или WebSocket — ещё 1–2 недели. gRPC — 2–3 недели, включая кодогенерацию. Стоимость рассчитывается индивидуально после анализа API и требований к offline-поведению. Оценим проект за 1 день — свяжитесь для консультации.