Конвертер валют для мобільних додатків під ключ

Відзначимо: при конвертації великих сум через округлення Float виникає похибка, яку користувач сприймає як баг. Технічно конвертер простий, але помилки в арифметиці, кеші або API-інтеграції перетворюють його на джерело скарг. Розберемо, як побудувати надійний модуль з нуля: від вибору провайдера курсів до обробки крайових випадків з локалями та rounding. Наша команда — 7 років у мобільній розробці, 30+ реалізованих fintech-модулів. Ми знаємо всі підводні камені та гарантуємо точність на всіх пристроях.

Як вибрати API для курсів валют?

Вибір API залежить від вимог до частоти оновлення та набору валют. Порівняємо популярні варіанти:

ExchangeRate-API в 3 рази дешевший за Fixer.io на середньому обсязі запитів. Для більшості додатків достатньо щоденного оновлення — НБУ віддає XML за адресою https://bank.gov.ua/NBUStatService/v1/statdirectory/exchange, парсимо через XMLParser на iOS або XmlPullParser на Android. Зверніть увагу: НБУ використовує UTF-8 і може змінювати формат відповіді. Ми завжди застосовуємо автоматичні тести регресії на sandbox-даних і передбачаємо fallback на іншого провайдера.

Чому Decimal, а не Float?

Ніколи не використовуйте Float або Double для фінансових розрахунків. Різниця в копійках при конвертації великих сум буде помітною. Порівняйте точність:

На iOS використовуємо Decimal, на Android — BigDecimal. Вони гарантують точність до копійки та коректне округлення за правилами фінансової математики. Детальніше про Тип даних Decimal.

Офлайн-кешування та фонова синхронізація

Курси зберігаємо локально: Core Data / Room для можливості роботи офлайн з останніми відомими значеннями. Показуємо мітку часу останнього оновлення — користувач повинен розуміти, наскільки актуальні дані. Для найсвіжіших курсів використовуємо фонову синхронізацію через WorkManager (Android) або BGTaskScheduler (iOS). На одному проекті ми реалізували TTL у 30 хвилин і кеш на 7 днів. Користувач завжди бачить актуальність даних, а при відсутності мережі — попередження.

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 = ""
        }
    }
}

Процес роботи над конвертером

1. Аналітика — збір вимог (валюти, точність, частота оновлення) та вибір API.
2. Проектування — архітектура: шар даних, репозиторій, кеш, view model (MVVM + Clean Architecture).
3. Реалізація — кодова база з юніт-тестами (20+ тестів на арифметику та кешування).
4. Інтеграція — підключення вибраного API, обробка помилок (немає мережі, ліміт запитів, зміна формату).
5. Тестування — на 10 реальних пристроях з різними локалями та регіонами.
6. Деплой — публікація в 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. Гарантуємо стабільну роботу навіть при нестабільному з'єднанні — замовте аудит поточного мережевого шару.

Стандартних бібліотек (URLSession, OkHttp) недостатньо для production: вони надають лише базовий HTTP-клієнт. Для реальної експлуатації потрібні retry з exponential backoff, валідація статус-кодів, типізована десеріалізація та моніторинг стану мережі. Без цього додаток втрачає дані та користувачів. Ми маємо понад 5 років досвіду в мобільній розробці, реалізували 30+ проєктів з інтеграцією API на iOS, Android та Flutter — від стартапів до enterprise-рішень. Сертифіковані iOS/Android розробники гарантують якість коду.

Як вибрати протокол для інтеграції API?

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%. Економія трафіку була значною при 100 000 активних користувачів.

Як забезпечити надійність з'єднання та offline-first?

Користувачі втрачають мережу в метро, ліфті, тунелі. Мобільний додаток зобов'язаний працювати без інтернету — хоча б у read-only режимі. Ми впроваджуємо патерн offline-first:

1. При відкритті екрану спочатку показуємо дані з локального кешу (Core Data / Room).
2. Паралельно виконуємо мережевий запит, оновлюємо UI після відповіді.
3. Якщо мережа недоступна — показуємо кешовані дані та позначку «немає з'єднання».
4. При відновленні мережі автоматично синхронізуємо зміни.

Для кешування HTTP-відповідей використовуємо URLCache (iOS) та OkHttp Cache (Android) з підтримкою Cache-Control. Для структурованих даних — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback відстежують стан мережі та тригерять оновлення. Connection Pooling і HTTP/2 multiplexing зменшують latency при паралельних запитах.

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. Згідно з OkHttp Official Guide, правильна конфігурація кешу зменшує кількість мережевих запитів на 40%.

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 — запити з перетинаючимися даними оновлюють кеш без дублювання.

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 (менше залежностей). TLS 1.3 забезпечує безпеку з'єднання.

Чому важливий certificate pinning?

Корпоративний проксі може перехопити HTTPS через підміну сертифіката. Certificate pinning запобігає цьому: додаток приймає тільки конкретний сертифікат або публічний ключ. Alamofire: ServerTrustManager з PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner з SHA-256 хешем. Операційна складність: при ротації сертифіката старі версії додатку перестають працювати. Рішення — pinning на публічний ключ CA або підтримка кількох пінів з grace period. Правильне впровадження pinning гарантує захист від MITM-атак.

Що входить у роботу

Ми передаємо: вихідний код мережевого шару, документацію по використовуваних бібліотеках, інструкцію з ротації сертифікатів, підтримку протягом 2 тижнів після здачі.

Терміни та вартість

Реалізація мережевого шару з REST, retry, кешуванням та offline-режимом — 1–2 тижні. Додавання GraphQL або WebSocket — ще 1–2 тижні. gRPC — 2–3 тижні, включаючи кодогенерацію. Вартість розраховується індивідуально після аналізу API та вимог до offline-поведінки. Оцінимо проєкт за 1 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.