Інтеграція логістичних сервісів DHL у мобільний додаток

Інтеграція логістичних сервісів DHL у мобільний додаток

Типова ситуація: інтернет-магазин з 5000 замовлень на місяць витрачає до 20 годин на тиждень на ручне створення накладних та перевірку статусів. Помилки в розрахунку об'ємної ваги призводять до переплати 30-50%, а вибір невірного API DHL блокує відправлення в окремих регіонах. Наші спеціалісти мають понад 8 років досвіду в інтеграції логістичних API, реалізували 30+ успішних проектів. Ми вирішуємо ці проблеми за допомогою інтеграції DHL API — від вибору endpoint'ів до публікації в сторах. Автоматизація розрахунку тарифів дозволяє клієнтам економити до 20% на доставці за рахунок вибору оптимального продукту DHL.

DHL Group об'єднує кілька підрозділів, у кожного свій API. Помилка у виборі призводить до недіючого функціоналу або неочікуваних помилок авторизації.

Як вибрати відповідний API DHL для мобільного додатку?

Для більшості e-commerce додатків потрібен DHL Express API (міжнародні відправлення) або DHL Parcel (доставка по Німеччині/Європі). DHL Express використовує Basic Auth, а DHL Parcel — OAuth 2.0. Ми підкажемо оптимальний варіант під вашу бізнес-модель.

Як працює авторизація в DHL API?

DHL Express API використовує Basic Auth з обліковими даними DHL акаунта. У production потрібен реальний акаунт DHL Express з активованим API-доступом — sandbox і production використовують різні credentials. DHL Parcel (новий API) працює через OAuth 2.0 Client Credentials Flow. Отримуємо access_token через POST /oauth/token і використовуємо в кожному запиті. Токен живе 3600 секунд — кешуємо та оновлюємо автоматично.

Розрахунок тарифів: чому важлива об'ємна вага?

Endpoint для розрахунку вартості DHL Express:

GET /rates?accountNumber={account}&originCountryCode=UA
    &originCityName=Kyiv&destinationCountryCode=DE
    &destinationCityName=Berlin&weight=2.5&length=30
    &width=20&height=15&plannedShippingDateAndTime=YYYY-MM-DDTHH:MM:SS

Повертає список продуктів (EXPRESS WORLDWIDE, EXPRESS 12:00 і т.д.) з цінами та термінами доставки. У мобільному додатку показуємо користувачеві порівняння варіантів у вигляді списку.

Критичний момент: вага та габарити. DHL рахує об'ємну вагу: (довжина × ширина × висота) / 5000. Береться максимум з фактичної та об'ємної ваги. Згідно з офіційною документацією DHL, неточність введення розмірів може збільшити вартість на 30-50%. Додаток повинен пояснювати користувачеві причину підсумкової ваги. Детальніше про об'ємну вагу.

Як створити відправлення та етикетку?

POST /shipments створює відправлення та повертає трек-номер і URL етикетки у форматі PDF або ZPL (для термопринтерів). Для генерації етикетки в додатку на iOS використовуємо WKWebView для рендерингу PDF або UIPrintInteractionController для прямого друку. На Android — PdfRenderer або інтент на друк через PrintManager.

Відстеження в реальному часі: вебхуки чи polling?

DHL Shipment Tracking API (GET /tracking/shipments?trackingNumber=...) повертає повну історію подій з кодами та описами. Частота оновлення: раз на 30 хвилин достатньо для більшості сценаріїв. Ліміти API в sandbox — 250 запитів на добу.

Для push-сповіщень про статус: DHL Tracking Webhook (доступний для enterprise-акаунтів) надсилає події в реальному часі. Альтернатива — polling через WorkManager / BGAppRefreshTask. Webhook працює в 2 рази ефективніше за polling за навантаженням на сервер.

Практичний кейс

Для клієнта — інтернет-магазину електроніки з 3000 замовлень на місяць — ми інтегрували DHL Express API. Раніше співробітники витрачали 15 годин на тиждень на створення накладних вручну. Після інтеграції час скоротився до 1 години на перевірку помилок. Крім того, автоматичний вибір оптимального тарифу зменшив середню вартість доставки на 18%. Проект включав авторизацію, розрахунок вартості з урахуванням об'ємної ваги, генерацію етикеток та трекінг через webhook.

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

• Підбір відповідного API DHL (Express, Parcel, eCommerce).
• Реалізація авторизації (Basic Auth або OAuth 2.0).
• Інтеграція розрахунку тарифів і створення замовлень.
• Генерація етикеток (PDF/ZPL) і друк.
• Відстеження з real-time сповіщеннями.
• Тестування в sandbox і production.
• Підготовка документації та навчання команди.

Які терміни інтеграції DHL?

1. Аналіз — уточнюємо вимоги, обираємо API, проектуємо архітектуру (2-3 дні).
2. Інтеграція — реалізуємо авторизацію, розрахунок, створення відправлень (1-2 тижні).
3. Відстеження — додаємо polling або вебхуки, push-сповіщення (1 тиждень).
4. Тестування — покриваємо edge case'и, навантажувальне тестування (3-5 днів).
5. Публікація — завантажуємо в App Store / Google Play, оновлюємо конфігурації (2-4 дні).

Орієнтовні терміни: від 2 тижнів для базового відстеження та розрахунку до 4 тижнів для повного циклу з етикетками та вебхуками. Вартість розраховується індивідуально за результатами аудиту. Зв'яжіться з нами для точної оцінки вашого проекту.

Порівняння методів отримання статусу доставки

Підсумок: webhook – найкращий вибір для мобільних додатків з високим навантаженням.

Отримайте консультацію з інтеграції DHL у ваш мобільний додаток – наш досвід і гарантія якості забезпечать стабільну роботу. Економія на операційних витратах може досягати 15-20% за рахунок вибору оптимального тарифу та автоматизації. Окупність інтеграції протягом 3-6 місяців.

Інтеграція 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 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.