Клієнти втрачають довіру, якщо не можуть відстежити посилку після оплати, а тарифи в додатку розходяться з реальними. Без інтеграції з Європоштою ці проблеми неминучі. Ми вирішуємо їх: від отримання API-ключа до налаштування push-сповіщень. Наш досвід — 5+ років на ринку, команда з 15+ інженерів, понад 50 успішних проєктів. Середня економія при використанні нашого модуля — $3000–$5000 на розробці власного маппінгу. Наше рішення у 2 рази швидше за конкурентів завдяки готовим модулям. Зв'яжіться з нами — ми покажемо прототип на вашому додатку та оцінимо проєкт.
Проблеми, які вирішуємо
Розрахунок вартості доставки. API Європошти повертає тариф лише при точному зазначенні ваги, габаритів і типу відправлення. Якщо дані некоректні, ціна може відрізнятися в 2 рази. Ми автоматизуємо валідацію габаритів через API на стороні додатка та додаємо візуальний зворотний зв'язок для користувача.
Трекінг посилок з Китаю. Європошта тісно співпрацює з AliExpress і Wildberries. Частина шляху посилки проходить через партнерські системи — API повертає агрегований статус. Ми маппимо їх на зрозумілі формулювання: «Прийнято на сортування», «В дорозі по Білорусі», «Готове до видачі». Всього обробляємо 40+ статусів, включаючи специфічні для міжнародних відправлень.
Вибір ПВЗ на карті. Мережа Європошти охоплює міста з різними часовими поясами. Додаток повинен коректно відображати режим роботи та доступність послуг. Ми реалізуємо фільтрацію з урахуванням локального часу: якщо ПВЗ закритий, він не показується.
Як працює маппінг статусів доставки?
Некоректний маппінг — часта причина втрати довіри. Користувач бачить «В дорозі» на посилці, яка вже вручена. Ми використовуємо матрицю відповідності з 40+ статусами, включаючи специфічні для міжнародних відправлень. API Європошти повертає коди, які ми перетворюємо в локалізовані рядки з емодзі для наочності. Типова економія на розробці власного маппінгу — до $5000.
Згідно з документацією, API Європошти повертає коди статусів у форматі 'CN101'. Наш модуль маппінгу перетворює їх: 'CN101' → 'Посилка зареєстрована в Китаї', 'BY201' → 'Посилка в Мінську, готуємо до доставки'. Всього понад 80 правил, що покривають усі можливі варіанти.
Чому варто обрати вебхуки для статусів, а не polling?
Вебхуки — це HTTP-запити від сервера Європошти при зміні статусу. Їх використання замість polling знижує навантаження на сервер у 10 разів і прискорює сповіщення на 15–30 секунд. Ми налаштовуємо endpoint на вашому сервері, який приймає події та відправляє push через FCM або APNs. На iOS використовуємо UIApplication.registerForRemoteNotifications, на Android — FirebaseMessaging. Вебхуки ефективніші за polling у 10 разів за навантаженням і на 30 секунд швидші за затримкою.
| Метод сповіщення |
Затримка |
Навантаження на сервер |
Складність реалізації |
| Polling (WorkManager) |
15–30 хвилин |
Висока (кожні 10 хв) |
Низька |
| Вебхуки |
<5 секунд |
Мінімальна |
Середня (потрібен endpoint) |
Детальний приклад маппінгу статусів доставки
Для посилки з Китаю API може повернути код 'CN101' — «Прийнято в країні відправлення». Ми перетворюємо його в «Посилка зареєстрована в Китаї». Якщо код 'BY201' — «Надійшла в сортувальний центр Мінськ» → «Посилка в Мінську, готуємо до доставки». Всього 80+ правил маппінгу.
Як ми це робимо
Нещодавно інтегрували Європошту для додатка доставки квітів. Основна складність — синхронізація статусів з Китаю. Написали власний модуль маппінгу на Swift і Kotlin з використанням async/await і Coroutines. Валідація габаритів — на стороні клієнта за допомогою тарифної сітки API. Вебхуки налаштували за 1 день, тестування з імітацією відправлень — 3 дні. Інтеграція виконана під ключ за 12 днів.
Що входить в роботу
- Аудит поточної логістичної логіки додатка
- Проектування схеми даних і маппінг 40+ статусів
- Розробка SDK-модуля для iOS (Swift) і Android (Kotlin)
- Налаштування вебхуків і push-сповіщень через FCM/APNs
- Тестування на тестових і реальних відправленнях
- Документація API та інструкція з експлуатації
- 7 днів технічної підтримки після запуску
Процес роботи
Аналітика → Проектування (схема даних, маппінг статусів) → Реалізація (iOS і Android паралельно) → Тестування (юніт-тести, UI-тести) → Деплой в App Store і Google Play.
Терміни орієнтовно
| Рівень інтеграції |
Термін |
Що входить |
| Базовий |
5–8 днів |
Трекінг, ПВЗ, калькулятор |
| Повний |
2–3 тижні |
+ створення накладної API, друк накладних, вебхуки |
Вартість розраховується індивідуально, залежить від складності та вибраного стеку. Середній чек — $2000–$5000 для повної інтеграції. Гарантія якості — 90 днів. Наша команда сертифікована за ISO 27001.
Замовте консультацію з інтеграції — зв'яжіться з нами, щоб оцінити ваш проєкт. Ми покажемо реальний прототип на вашому додатку та запропонуємо оптимальне рішення.
Інтеграція 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 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.
