Интеграция с Яндекс API: полное руководство по автоматизации

Сеть автосервисов из Нижнего Новгорода с 8 филиалами тратила 46 часов в неделю на рутинные операции с Яндекс.Маркетом, Яндекс.Доставкой и Яндекс.Картами. Менеджеры вручную обновляли цены на 2400 позиций запчастей на Маркете, копировали трек-номера из Доставки в CRM и проверяли отзывы на Картах по каждому филиалу. Ошибки при ручном переносе данных стоили компании 180 000 ₽ ежемесячно — из-за неактуальных цен терялись заказы, а непроработанные негативные отзывы на Картах отпугивали клиентов.

После интеграции через Яндекс API все три сервиса заработали в единой автоматизированной системе. Цены на Маркете обновлялись автоматически при изменении в 1С, трек-номера подтягивались из Доставки в CRM без участия менеджеров, а уведомления о новых отзывах на Картах приходили в Telegram-канал руководителя. Время на рутину сократилось с 46 до 3 часов в неделю, а потери от ошибок упали до нуля.

Яндекс API — это набор программных интерфейсов от Яндекса, который включает API Маркета, Доставки, Карт, Метрики, Директа, Облака и других сервисов. Интеграция позволяет автоматизировать управление продажами, логистикой, аналитикой и рекламой из единой системы.

Что можно автоматизировать через Яндекс API:

• ›Яндекс.Маркет API — управление товарами, ценами, остатками, заказами и акциями
• ›Яндекс.Доставка API — создание заказов на доставку, отслеживание, расчёт стоимости
• ›Яндекс.Карты API — геокодирование, построение маршрутов, отзывы и рейтинги
• ›Яндекс.Метрика API — аналитика трафика, конверсии, атрибуция
• ›Яндекс.Директ API — управление рекламными кампаниями и ставками
• ›Яндекс.Облако API — управление облачной инфраструктурой

По данным Яндекса, продавцы на Маркете с автоматизированной интеграцией через API получают на 35% больше заказов за счёт конкурентных цен и актуальных остатков.

Если вы работаете не только с Яндексом, но и с другими маркетплейсами — читайте интеграцию API маркетплейсов и интеграцию API с Яндекс.

Яндекс.Маркет предоставляет мощный API для автоматизации работы продавцов. Это один из самых востребованных API в российской e-commerce — через него проходят миллионы заказов ежедневно.

Основные категории методов Яндекс.Маркет API:

1. Управление товарами (Content API): - POST /campaigns/{campaignId}/offer-mappings — создание и обновление карточек - GET /campaigns/{campaignId}/offer-mappings — получение списка товаров - POST /campaigns/{campaignId}/offers/update — обновление параметров офферов - Управление категориями, характеристиками и описаниями

2. Управление ценами (Prices API): - POST /campaigns/{campaignId}/offer-prices — установка цен - GET /campaigns/{campaignId}/offer-prices — получение текущих цен - Управление скидками и акционными ценами - Мониторинг рекомендованных цен от Маркета

3. Управление остатками (Stocks API): - POST /campaigns/{campaignId}/stocks — обновление остатков - GET /campaigns/{campaignId}/stocks — получение текущих остатков - Распределение по складам и моделям размещения (FBS, FBY, DBS)

4. Управление заказами (Orders API): - GET /campaigns/{campaignId}/orders — список заказов - PUT /campaigns/{campaignId}/orders/{orderId}/status — обновление статуса - POST /campaigns/{campaignId}/orders/{orderId}/delivery/shipments — отгрузка - Обработка возвратов и отмен

5. Аналитика (Stats API): - GET /campaigns/{campaignId}/stats — статистика продаж - Конверсия карточек, позиции в выдаче - Отзывы и рейтинги товаров

Технические характеристики Яндекс.Маркет API:

Пример авторизации через OAuth 2.0:

 1import httpx
 2from datetime import datetime, timedelta
 3
 4class YandexMarketAPI:
 5    BASE_URL = "https://api.partner.market.yandex.ru"
 6    
 7    def __init__(self, client_id: str, client_secret: str, refresh_token: str):
 8        self.client_id = client_id
 9        self.client_secret = client_secret
10        self.refresh_token = refresh_token
11        self.access_token = None
12        self.token_expires = None
13    
14    async def _refresh_access_token(self):
15        """Обновить access_token через refresh_token"""
16        async with httpx.AsyncClient() as client:
17            response = await client.post(
18                "https://oauth.yandex.ru/token",
19                data={
20                    "grant_type": "refresh_token",
21                    "refresh_token": self.refresh_token,
22                    "client_id": self.client_id,
23                    "client_secret": self.client_secret,
24                }
25            )
26            data = response.json()
27            self.access_token = data["access_token"]
28            self.token_expires = datetime.now() + timedelta(
29                seconds=data["expires_in"] - 60
30            )
31    
32    async def _get_headers(self) -> dict:
33        if not self.access_token or datetime.now() >= self.token_expires:
34            await self._refresh_access_token()
35        return {
36            "Authorization": f"Bearer {self.access_token}",
37            "Content-Type": "application/json",
38        }
39    
40    async def get_orders(self, campaign_id: str, status: str = "PROCESSING") -> dict:
41        """Получить заказы по статусу"""
42        headers = await self._get_headers()
43        async with httpx.AsyncClient() as client:
44            response = await client.get(
45                f"{self.BASE_URL}/v2/campaigns/{campaign_id}/orders",
46                headers=headers,
47                params={"status": status, "limit": 100}
48            )
49            response.raise_for_status()
50            return response.json()
51    
52    async def update_stocks(self, campaign_id: str, stocks: list[dict]) -> dict:
53        """Обновить остатки товаров"""
54        headers = await self._get_headers()
55        async with httpx.AsyncClient() as client:
56            response = await client.post(
57                f"{self.BASE_URL}/v2/campaigns/{campaign_id}/stocks",
58                headers=headers,
59                json={"skus": stocks}
60            )
61            response.raise_for_status()
62            return response.json()

Модели размещения на Яндекс.Маркете:

Подробнее о возможностях API маркетплейсов читайте в статье интеграция API маркетплейсов.

Яндекс.Доставка — один из самых удобных сервисов доставки для интернет-магазинов в России. API позволяет автоматизировать создание заказов, отслеживание посылок и расчёт стоимости доставки.

Основные методы Яндекс.Доставка API:

1. Расчёт стоимости и сроков: - POST /delivery/calculate — расчёт стоимости по параметрам - GET /delivery/options — доступные варианты доставки - GET /delivery/intervals — доступные интервалы

2. Управление заказами: - POST /orders — создание заказа на доставку - GET /orders/{orderId} — получение информации о заказе - POST /orders/{orderId}/cancel — отмена заказа - GET /orders/{orderId}/track — отслеживание посылки

3. Управление складами: - POST /warehouses — создание склада - GET /warehouses — список складов - PUT /warehouses/{warehouseId} — обновление параметров

4. Этикетки и документы: - GET /orders/{orderId}/label — получение этикетки - GET /orders/{orderId}/invoice — получение накладной - POST /orders/batch/labels — массовая печать этикеток

Технические характеристики Яндекс.Доставка API:

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

 1async def create_delivery_order(
 2    api: YandexDeliveryAPI,
 3    order_data: dict
 4) -> dict:
 5    """Создать заказ на доставку через Яндекс.Доставку"""
 6    payload = {
 7        "deliveryId": order_data["delivery_id"],
 8        "type": "DEFAULT",
 9        "deliveryInterval": {
10            "fromDate": order_data["date_from"],
11            "toDate": order_data["date_to"],
12        },
13        "recipient": {
14            "fullName": order_data["client_name"],
15            "phone": order_data["phone"],
16            "email": order_data.get("email"),
17        },
18        "deliveryAddress": {
19            "country": "Россия",
20            "city": order_data["city"],
21            "street": order_data["street"],
22            "house": order_data["house"],
23            "apartment": order_data.get("apartment"),
24            "postcode": order_data.get("postcode"),
25        },
26        "items": [
27            {
28                "name": item["name"],
29                "quantity": item["qty"],
30                "price": item["price"],
31                "weight": item.get("weight", 0.5),
32                "dimensions": {
33                    "length": item.get("length", 20),
34                    "width": item.get("width", 15),
35                    "height": item.get("height", 10),
36                },
37            }
38            for item in order_data["items"]
39        ],
40    }
41    
42    headers = await api._get_headers()
43    async with httpx.AsyncClient() as client:
44        response = await client.post(
45            f"{api.BASE_URL}/v2/orders",
46            headers=headers,
47            json=payload,
48        )
49        response.raise_for_status()
50        result = response.json()
51    
52    return {
53        "order_id": result["order"]["id"],
54        "tracking_number": result["order"].get("trackingNumber"),
55        "status": result["order"]["status"],
56    }

Сравнение Яндекс.Доставки с другими сервисами:

Интеграция с Яндекс.Доставкой позволяет автоматизировать весь цикл логистики — от расчёта стоимости до отслеживания доставки в реальном времени.

Если вам нужна интеграция с другими системами доставки — читайте интеграцию API доставки.

Помимо Маркета и Доставки, Яндекс предоставляет два мощных API, которые критически важны для бизнеса: Яндекс.Карты API и Яндекс.Метрика API.

Яндекс.Карты API — основные возможности:

Геокодирование — преобразование адресов в координаты и обратно: - Прямой геокодирование: адрес → координаты - Обратный геокодирование: координаты → адрес - Пакетное геокодирование до 25 адресов за запрос

Маршрутизация — расчёт маршрутов и расстояний: - Автомобильные, пешеходные и велосипедные маршруты - Матрица расстояний (до 50 точек) - Учёт пробок в реальном времени

Поиск организаций: - Поиск по категории, названию, координатам - Отзывы и рейтинги организаций - Часы работы и контактные данные

Статические карты: - Генерация изображений карт для email и документов - Наложение маркеров и маршрутов

Яндекс.Метрика API — аналитика сайта:

Пример получения аналитики из Метрики:

 1async def get_metrika_stats(
 2    api_token: str,
 3    counter_id: str,
 4    date_from: str,
 5    date_to: str,
 6) -> dict:
 7    """Получить статистику из Яндекс.Метрики"""
 8    headers = {"Authorization": f"OAuth {api_token}"}
 9    params = {
10        "ids": counter_id,
11        "metrics": "ym:s:visits,ym:s:users,ym:s:pageDepth,ym:s:bounceRate",
12        "dimensions": "ym:s:date",
13        "date1": date_from,
14        "date2": date_to,
15        "accuracy": "full",
16    }
17    
18    async with httpx.AsyncClient() as client:
19        response = await client.get(
20            "https://api-metrika.yandex.net/stat/v1/data",
21            headers=headers,
22            params=params,
23        )
24        response.raise_for_status()
25        data = response.json()
26    
27    return {
28        "total_visits": data["totals"][0],
29        "total_users": data["totals"][1],
30        "avg_depth": data["totals"][2],
31        "bounce_rate": data["totals"][3],
32        "daily": [
33            {
34                "date": row["dimensions"][0]["name"],
35                "visits": row["metrics"][0],
36                "users": row["metrics"][1],
37            }
38            for row in data["data"]
39        ],
40    }

Практические сценарии использования Яндекс.Карт API в бизнесе:

Если вам нужна интеграция аналитики с другими системами — читайте интеграцию API с CRM и интеграцию API с сайтом.

Интеграция с экосистемой Яндекса — это комплексный проект, который затрагивает несколько сервисов. Вот пошаговый план, который я использую в своих проектах.

Этап 1: Регистрация и получение доступов (1-2 дня)

1. 1.Создайте аккаунт разработчика на developer.market.yandex.ru
2. 2.Получите OAuth-токен через Яндекс.OAuth
3. 3.Зарегистрируйте приложение в Яндекс.Облаке (для Карт и Метрики)
4. 4.Настройте права доступа — каждый сервис требует отдельных разрешений
5. 5.Получите campaignId для Маркета (в личном кабинете продавца)

Этап 2: Проектирование архитектуры (2-3 дня)

• ›Определите, какие сервисы Яндекса будут интегрированы
• ›Спроектируйте единую точку входа для всех API
• ›Разработайте систему кэширования (Redis) для частых запросов
• ›Настройте очереди сообщений (RabbitMQ) для асинхронных операций
• ›Спроектируйте базу данных для хранения синхронизированных данных

Этап 3: Разработка базового модуля (3-5 дней)

• ›Реализация OAuth 2.0 авторизации с автоматическим обновлением токенов
• ›Модуль rate limiting (60-120 запросов/мин в зависимости от API)
• ›Система retry с экспоненциальной задержкой
• ›Логирование всех запросов и ответов
• ›Обработка ошибок и уведомления

Этап 4: Интеграция сервисов (5-10 дней)

• ›Яндекс.Маркет: синхронизация товаров, цен, остатков, заказов
• ›Яндекс.Доставка: создание заказов, отслеживание, этикетки
• ›Яндекс.Карты: геокодирование, маршруты, отзывы
• ›Яндекс.Метрика: аналитика, отчёты, конверсии

Этап 5: Тестирование и запуск (3-5 дней)

• ›Юнит-тесты для каждого модуля
• ›Интеграционные тесты с sandbox-окружением Яндекса
• ›Нагрузочное тестирование
• ›Мониторинг и алертинг

Пример единого модуля для работы с Яндекс API:

 1from dataclasses import dataclass
 2from enum import Enum
 3
 4class YandexService(Enum):
 5    MARKET = "market"
 6    DELIVERY = "delivery"
 7    METRIKA = "metrika"
 8    MAPS = "maps"
 9
10@dataclass
11class YandexAPIConfig:
12    client_id: str
13    client_secret: str
14    refresh_token: str
15    metrika_token: str
16    maps_api_key: str
17    campaign_id: str
18
19class YandexEcosystem:
20    """Единый модуль для работы со всеми сервисами Яндекса"""
21    
22    def __init__(self, config: YandexAPIConfig):
23        self.config = config
24        self.market = YandexMarketAPI(
25            config.client_id, config.client_secret, config.refresh_token
26        )
27        self.delivery = YandexDeliveryAPI(
28            config.client_id, config.client_secret, config.refresh_token
29        )
30        self.metrika = YandexMetrikaAPI(config.metrika_token)
31        self.maps = YandexMapsAPI(config.maps_api_key)
32    
33    async def sync_order_full_cycle(self, order: dict) -> dict:
34        """Полный цикл обработки заказа: Маркет → Доставка → Метрика"""
35        # 1. Получаем заказ с Маркета
36        market_order = await self.market.get_order(
37            self.config.campaign_id, order["id"]
38        )
39        
40        # 2. Геокодируем адрес доставки
41        coords = await self.maps.geocode(market_order["delivery"]["address"])
42        
43        # 3. Создаём заказ на доставку
44        delivery_order = await self.delivery.create_order({
45            "recipient": market_order["buyer"],
46            "address": market_order["delivery"]["address"],
47            "coordinates": coords,
48            "items": market_order["items"],
49        })
50        
51        # 4. Обновляем статус на Маркете
52        await self.market.update_order_status(
53            self.config.campaign_id, order["id"], "SHIPPED",
54            tracking_number=delivery_order["tracking_number"],
55        )
56        
57        # 5. Логируем конверсию в Метрике
58        await self.metrika.log_goal("order_shipped", order["id"])
59        
60        return {
61            "market_order_id": order["id"],
62            "delivery_order_id": delivery_order["order_id"],
63            "tracking": delivery_order["tracking_number"],
64            "coordinates": coords,
65        }

Если вам нужна помощь с проектированием архитектуры — читайте разработку REST API и FastAPI для API.

Расскажу о реальном проекте, который реализовал для сети автосервисов «АвтоМастер» из Нижнего Новгорода.

Заказчик: Сеть из 8 автосервисов с интернет-магазином запчастей на Яндекс.Маркете.

Проблема: - 2400 позиций запчастей на Маркете — цены обновлялись вручную 4 часа в день - 15-20 ошибок в трек-номерах ежемесячно (ручное копирование из Доставки) - Негативные отзывы на Яндекс.Картах оставались без ответа 2-3 дня - Нет единой аналитики по всем каналам продаж - Потери от ошибок: 180 000 ₽/мес

Решение — интеграция через Яндекс API:

Реализованные интеграции:

1. Яндекс.Маркет — синхронизация товаров и цен: - Автоматическое обновление цен при изменении в 1С (каждые 30 минут) - Синхронизация остатков по 8 складам (по одному на филиал) - Обработка заказов: получение → подтверждение → отгрузка - Участие в акциях Маркета через API

2. Яндекс.Доставка — автоматизация логистики: - Автоматическое создание заказов на доставку - Получение трек-номеров и обновление статусов - Генерация этикеток для посылок - Отслеживание доставки в реальном времени

3. Яндекс.Карты — мониторинг репутации: - Ежечасная проверка новых отзывов по всем 8 филиалам - Автоматическое уведомление руководителя о негативных отзывах - Геокодирование адресов клиентов для оптимизации маршрутов

4. Яндекс.Метрика — единая аналитика: - Дашборд с конверсией по всем каналам - Атрибуция заказов: Маркет → Доставка → Оплата - Автоматические отчёты каждое утро в Telegram

Результаты за первые 3 месяца:

Ключевой инсайт: Главная выгода — не только экономия времени, но и рост заказов на 41% за счёт конкурентных цен и актуальных остатков. Алгоритм динамического ценообразования автоматически снижал цены на 3-5% относительно конкурентов, что давало преимущество в выдаче Маркета.

Если вас интересуют другие кейсы интеграции — читайте интеграцию API с Яндекс.

За 5 лет работы с Яндекс API я встретил десятки одних и тех же ошибок. Вот 7 самых costly, которые могут обойтись бизнесу в десятки тысяч рублей.

Ошибка 1: Хранение OAuth-токенов в коде

Многие разработчики хранят client_secret и refresh_token прямо в исходном коде. Если репозиторий публичный или попадёт в чужие руки — злоумышленник получит полный доступ к вашему аккаунту Яндекс.Маркета.

Решение: Используйте переменные окружения или секреты в Kubernetes/Docker. Никогда не коммитьте токены в Git.

Ошибка 2: Игнорирование rate limits

Яндекс.Маркет API: 60 запросов/мин, Яндекс.Доставка: 120 запросов/мин. При превышении — блокировка на 1-24 часа. Если синхронизация 2400 товаров идёт без пауз — блокировка гарантирована.

Решение: Реализуйте rate limiter с скользящим окном. Для массовых операций используйте батчи с паузами.

Ошибка 3: Отсутствие обработки ошибок API

Яндекс API возвращает разные коды ошибок: 400 (неверный запрос), 401 (истёк токен), 403 (нет прав), 429 (слишком много запросов), 500 (внутренняя ошибка). Без обработки — интеграция падает при первой же ошибке.

Решение: Реализуйте retry с экспоненциальной задержкой для 429 и 500. Для 401 — автоматическое обновление токена. Для 400 — логирование и уведомление.

Ошибка 4: Синхронизация «всего и сразу»

Попытка обновить все 2400 товаров за один запрос — гарантированный таймаут. API Яндекс.Маркета принимает максимум 200 товаров за запрос.

Решение: Батчевая обработка: разбивайте данные на части по 100-200 штук. Используйте асинхронные запросы для параллельной обработки батчей.

Ошибка 5: Нет мониторинга и алертинга

Если интеграция перестала работать, а вы узнали об этом через 3 дня — вы потеряли заказы, рейтинг и деньги.

Решение: Telegram/email-уведомления при ошибках. Дашборд с метриками успеха. Автоматические проверки доступности API каждые 5 минут.

Ошибка 6: Использование устаревших версий API

Яндекс регулярно обновляет API. Версия v1 Маркета уже deprecated — v2 имеет другие форматы запросов и ответов.

Решение: Используйте всегда последнюю стабильную версию API. Подпишитесь на changelog Яндекса. Версионируйте свой код.

Ошибка 7: Нет sandbox-тестирования

Тестирование на боевых данных — риск отправить реальные заказы, изменить реальные цены или создать реальные доставки.

Решение: Всегда начинайте с sandbox-окружения Яндекса. Тестируйте все сценарии на тестовых данных. Только после полного тестирования переходите на production.

Сводная таблица ошибок:

Если вам нужна помощь с интеграцией — читайте webhook-интеграцию и интеграцию API с сайтом.

Если вас заинтересовала интеграция с Яндекс API, рекомендую изучить следующие статьи:

Автор статьи: Дмитрий Малышев — Fullstack-разработчик с 6+ годами опыта в интеграции API. Реализовал более 15 проектов для экосистемы Яндекса — от базовой синхронизации товаров на Маркете до комплексных систем с Доставкой, Картами и Метрикой с ROI до 520%.

Хотите автоматизировать работу с Яндекс API? Обсудить проект →