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

Відзначимо: при конвертації великих сум через округлення 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: завжди передбачайте можливість зміни провайдера курсів.
• Немає перевірки строку кешу: користувач бачить курс тижневої давності без попередження.

Замовте розробку конвертера валют під ключ — отримайте готове рішення з вихідниками та підтримкою.