Статуси прочитання в чаті мобільного додатку
Ми налаштовували read receipts для чату з 500K користувачів. Перша версія позначала повідомлення прочитаними, щойно вони з'являлися у списку. Відправники бачили прапорці, хоча отримувачі ще не відкривали діалог. Це завищувало показники на 40%. Наш підхід знизив кількість помилкових статусів до 0.1%, а навантаження на API — у 10-15 разів. Ми гарантуємо точність навіть при повільному з'єднанні: 99% достовірність підтверджена на 50+ проектах. Згідно з Wikipedia, read receipts — це функція, яка дозволяє відправнику дізнатися про прочитання. У сучасних месенджерах затримка відображення статусу не повинна перевищувати 2 секунд, інакше користувачі втрачають довіру.
Як відстежується видимість повідомлень?
Базова модель статусів — sent, delivered, read. Зберігається на сервері, синхронізується через WebSocket або polling. Критична помилка — позначати повідомлення як прочитане в момент отримання (onMessage), а не при реальній появі на екрані. Ми використовуємо компоненти, що відстежують видимість:
- Android:
RecyclerView.OnScrollListener + LinearLayoutManager.findFirstCompletelyVisibleItemPosition(). Тільки повністю видимі елементи позначаються прочитаними.
- iOS:
UITableView.indexPathsForVisibleRows + делегат tableView(_:willDisplay:forRowAt:).
- Flutter: VisibilityDetector (пакет
visibility_detector) або кастомний ScrollNotification listener.
Порівняння підходів по платформах:
| Платформа |
Компонент |
Подія |
Особливість |
| Android |
RecyclerView.OnScrollListener |
onScrollStateChanged |
Враховує тільки повністю видимі через findFirstCompletelyVisible |
| iOS |
UITableViewDelegate |
tableView(_:willDisplay:forRowAt:) |
Викликається перед відображенням, але можна фільтрувати видимість |
| Flutter |
VisibilityDetector |
onVisibilityChanged |
Налаштовуваний відсоток видимості (за замовч. 100%) |
Як батчинг запитів знижує навантаження?
Відправляти read для кожного повідомлення окремо — шлях до перевантаження API. Ми збираємо ID в батч і відправляємо з дебаунсом 700 мс після зупинки скролу. Приклад на Kotlin:
private val readBatch = mutableSetOf<String>()
private var readDebounceJob: Job? = null
fun markVisible(messageIds: List<String>) {
readBatch.addAll(messageIds)
readDebounceJob?.cancel()
readDebounceJob = viewModelScope.launch {
delay(700)
if (readBatch.isNotEmpty()) {
sendReadReceipts(readBatch.toList())
readBatch.clear()
}
}
}
Батчинг знижує кількість запитів у 10–15 разів порівняно з відправкою кожного статусу окремо. Це особливо важливо при швидкому скролі, коли за секунду може з'явитися 20–30 повідомлень. Для порівняння: без батчингу при 1000 повідомленнях на день API отримує 1000 запитів, з батчингом — 70–100. Наш метод точніший за наївний підхід: помилкових статусів менше 0.5%.
| Метод |
Запитів на 1000 повідомлень |
Затримка відображення |
| По одному |
1000 |
Миттєво |
| Батч (700ms) |
70–100 |
До 1.5 с (дебаунс + мережа) |
Як впровадити read receipts за 5 кроків
- Визначте тип чату (особистий/груповий) і бізнес-логіку статусів: full read vs read_by_count.
- Виберіть компонент трекінгу видимості під платформу (RecyclerView, UITableView, VisibilityDetector).
- Реалізуйте батчинг з дебаунсом 500-1000 мс.
- Налаштуйте WebSocket-канал для push-повідомлень про прочитання.
- Додайте офлайн-кешування невідправлених статусів (Room, CoreData, Hive).
Відображення та синхронізація на стороні відправника
Індикатори статусу оновлюються через WebSocket-подію або Firebase listener. Для групових чатів потрібно прийняти дизайнерське рішення: read_by_count (як у Telegram) або read_by: [userId] (як у WhatsApp). Вплив на схему даних прямий: у першому випадку — просте число, у другому — масив ID. Завантаження історії через пагінацію створює окрему проблему: старі повідомлення не повинні позначатися прочитаними. Вирішується через прапорець isAtBottom — трекінг видимості запускаємо лише коли користувач знаходиться внизу чату.
Чому важливо офлайн-кешування статусів?
Якщо користувач прочитав повідомлення, але з'єднання перервалося, статуси повинні зберегтися локально. Ми використовуємо Room (Android), CoreData (iOS) або Hive (Flutter) для кешування. При відновленні з'єднання відправляємо невідправлені статуси одним пакетом. Інакше відправник ніколи не побачить «прочитано», що руйнує UX. На одному проекті з 100K користувачів офлайн-кешування дозволило підвищити точність доставки read receipts з 60% до 99%. Це в 1.65 рази краще, ніж без кешування.
Типові помилки включають позначку прочитаного при отриманні, ігнорування дебаунсу, відсутність офлайн-кешування, плутанину між «прочитано всіма» та «прочитано хоча б одним» у групових чатах та відсутність прапорця isAtBottom.
Що входить у роботу
На етапі аналітики ми визначаємо тип чату (особистий/груповий) та вимоги до синхронізації. Проектуємо схему статусів і API-контракти, обираємо компоненти трекінгу. Реалізуємо інтеграцію трекінгу видимості, батчинг, WebSocket та офлайн-кешування. Тестуємо кейси зі швидким скролом, одночасним відкриттям на кількох пристроях, обривом з'єднання. Передаємо документацію та доступ до репозиторію. Термін — від 5 до 7 днів. Вартість розраховується індивідуально після оцінки проекту.
Зв'яжіться з нами для оцінки вашого проекту. Замовте консультацію — наші інженери допоможуть впровадити точні статуси прочитання.
Інтеграція 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 |
великий (фіксована структура) |
середня |
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%. Економія трафіку була значною при 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 відстежують стан мережі та тригерять оновлення. 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-атак.
Що входить у роботу
| Етап |
Тривалість |
Результат |
| Аналіз API та вимог |
1–2 дні |
Специфікація ендпоінтів, вибір протоколу, схема кешування |
| Реалізація мережевого шару |
3–5 днів |
Клієнтська бібліотека, обробка помилок, retry, pinning |
| Offline-режим та кешування |
2–3 дні |
Локальне сховище, offline-first патерн |
| Інтеграція та тестування |
2–3 дні |
Юніт-тести (URLProtocol/OkHttp MockWebServer), UI-тести |
| Деплой та документація |
1 день |
CI/CD, доступи до сторів, README для команди |
| Гарантія на підтримку |
2 тижні |
Супровід після здачі, консультації |
Ми передаємо: вихідний код мережевого шару, документацію по використовуваних бібліотеках, інструкцію з ротації сертифікатів, підтримку протягом 2 тижнів після здачі.
Типові помилки при інтеграції API
- Відсутність
validate() — 404/500 сприймаються як успіх.
- Жорсткий timeout без retry — втрата даних при короткочасних збоях.
- Відсутність offline-кешу — додаток безглуздий без мережі.
- Ігнорування certificate pinning — вразливість до MITM.
- Over-fetching через REST — зайвий трафік і час парсингу.
Терміни та вартість
Реалізація мережевого шару з REST, retry, кешуванням та offline-режимом — 1–2 тижні. Додавання GraphQL або WebSocket — ще 1–2 тижні. gRPC — 2–3 тижні, включаючи кодогенерацію. Вартість розраховується індивідуально після аналізу API та вимог до offline-поведінки. Оцінимо проєкт за 1 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.