Интеграция логистических сервисов DHL в мобильное приложение

Интеграция логистических сервисов DHL в мобильное приложение

Типичная ситуация: интернет-магазин с 5000 заказов в месяц тратит до 20 часов в неделю на ручное создание накладных и проверку статусов. Ошибки в расчёте объёмного веса приводят к переплате 30-50%, а выбор неверного API DHL блокирует отправку в отдельных регионах. Мы решаем эти проблемы с помощью интеграции 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=RU
    &originCityName=Moscow&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'а по нагрузке на сервер.

Что входит в работу

• Подбор подходящего 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. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.

Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.

Как выбрать протокол для интеграции 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%. Экономия трафика составила около 15 000 ₽ в месяц при 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 отслеживают состояние сети и триггерят обновление.

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.

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

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 (меньше зависимостей).

gRPC: для высоконагруженных сервисов

gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.

Certificate Pinning и безопасность

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

Что входит в работу

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

Сроки и стоимость

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