CRM, 1С и интеграции

Переход API Яндекс Маркета с OAuth на API-Key

Переход API Яндекс Маркета с OAuth на API-Key обновляет авторизацию действующей интеграции продавца. В официальной документации OAuth отмечен как устаревший способ, а основным вариантом стал API-Key. Различие касается архитектуры доступа. OAuth-токен связан с пользователем, действует один год и открывает магазины, доступные этому сотруднику.

API-Key создаётся в кабинете продавца, привязывается к кабинету, работает до удаления владельцем и получает выбранные группы методов. В запросе он передаётся отдельным заголовком Api-Key вместо Authorization. Для переходного периода Яндекс Маркет допускает передачу обоих токенов, поэтому обновление можно проверить до окончательного переключения.

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

API-клиент получает единый способ добавления заголовка, журнал различает ошибки авторизации и доступа, а секрет хранится на сервере. После контрольного периода OAuth убирается из рабочей конфигурации. Команда получает устойчивый кабинетный доступ, понятные права и инструкцию по замене API-Key без поиска токена в нескольких модулях.

Срок: 7 рабочих дней

Когда стоит обратиться

Обычно к нам обращаются в таких ситуациях:

В запросах к Partner API передаётся OAuth-токен в заголовке Authorization вместе с oauth_client_id.
Интеграция зависит от учётной записи сотрудника и теряет доступ после изменения его роли в кабинете.
Компания хочет выдать отдельному модулю доступ только к заказам, ценам, коммуникациям или отчётам.
Несколько магазинов и фоновых заданий используют токены в разных конфигурациях, и их замена проходит вручную.

Что именно мы сделаем

Находим все OAuth-токены, заголовки, задания и приложения, которые обращаются к API Яндекс Маркета.

Сопоставляем рабочие методы с группами прав API-Key и кабинетами, где выполняются запросы.

Обновляем общий API-клиент, серверную конфигурацию и обработку ошибок авторизации и доступа.

Проверяем товары, заказы, отчёты и другие используемые сценарии с новым токеном на каждом магазине.

Завершаем переключение, убираем OAuth из рабочей конфигурации и передаём порядок ротации API-Key.

Что входит в стоимость

39 900 ₽ за всю работу

Инвентаризируем все запросы к Partner API, используемые OAuth-токены, client_id, кабинеты, магазины и задания. Вместе с владельцем кабинета подбираем минимально достаточные группы доступа API-Key, обновляем общий API-клиент и секреты, проверяем методы по каждому businessId и campaignId. На переходе используем предусмотренную Яндекс Маркетом параллельную передачу двух способов авторизации, затем оставляем API-Key и передаём порядок ротации и диагностики.

Что будет готово

Материалы

Передадим вам

Рабочая интеграция Partner API Яндекс Маркета с авторизацией через API-Key.
Матрица кабинетов, магазинов, методов и минимально достаточных групп доступа.
Централизованная серверная конфигурация токена и журнал ошибок авторизации и прав.
Протокол контрольных запросов и инструкция по созданию, проверке и ротации API-Key.

Проверка

Перед сдачей проверим

Каждый выбранный метод успешно выполняется с API-Key в правильном кабинете и магазине.
Фоновое задание обрабатывает контрольные данные и показывает результат без зависимости от OAuth пользователя.
Токен обладает выбранными группами прав, а его значение скрыто в пользовательском интерфейсе и журнале.
Замена API-Key выполняется через одно место конфигурации и подтверждается повторным набором контрольных запросов.

Как это выглядит на практике

Схема перехода API Яндекс Маркета с пользовательского OAuth на кабинетный API-Key

Заказы и остатки работают с кабинетным API-Key

01
Владелец кабинета создаёт API-Key с доступом к обработке заказов и учёту товаров для нужной интеграции.
02
Серверный клиент добавляет заголовок Api-Key и обращается к магазинам через их businessId и campaignId.
03
Ночное задание получает заказы и передаёт остатки, а журнал связывает каждый ответ с методом и магазином.
04
После контрольного периода OAuth удаляется из конфигурации, и дальнейшая ротация проходит централизованно.

Что понадобится для работы

От вас

Доступ к коду, серверной конфигурации и журналам действующей интеграции Яндекс Маркета.
Владелец или менеджер кабинета, который создаст API-Key по подготовленной матрице прав.
Список кабинетов, businessId, campaignId и рабочих методов для каждого магазина.
Контрольные товары, заказы, отчёты или сообщения для проверки фактически используемых сценариев.

Если у вас немного другая ситуация

Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.

Стоимость работ 39 900 ₽ полная стоимость известна заранее

3 000 ₽после подписания договора через Диадок
36 900 ₽после выполнения, демонстрации и приёмки результата

Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.

Часто спрашивают

Об этой услуге

Почему Яндекс Маркет рекомендует API-Key вместо OAuth?

Официальная документация отмечает OAuth как устаревший способ. API-Key связан с кабинетом, получает выбранные группы методов и сохраняет действие до удаления владельцем.

Как API-Key передаётся в запросе к Маркету?

Токен помещается в HTTP-заголовок Api-Key. Общий клиент добавляет его на сервере, поэтому значение хранится централизованно и скрывается из журналов и браузера.

Кто может создать API-Key в кабинете продавца?

Создание и управление токенами доступно владельцу кабинета и менеджеру кабинета. Мы заранее готовим название токена и перечень групп прав для выбранной интеграции.

Как долго действует API-Key Яндекс Маркета?

API-Key сохраняет действие до удаления в кабинете. Для управляемой безопасности компания может установить собственный цикл ротации и заменить ключ через централизованную конфигурацию.

Один ключ подходит для нескольких магазинов?

Ключ привязан к кабинету и открывает магазины внутри него согласно выбранным правам. Для нескольких кабинетов формируется явная таблица отдельных токенов и businessId.

Можно ограничить ключ только нужными методами?

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

Как переключиться без остановки фоновых заданий?

На контрольном этапе Яндекс Маркет допускает передачу обоих способов авторизации. Проверяем новый ключ на рабочих сценариях, затем оставляем API-Key в основной конфигурации.

Как принимается работа по переходу на API-Key?

Выполняем выбранный набор запросов для каждого кабинета и магазина, проверяем фоновые задания, права, обработку 401 и 403, журнал и централизованную замену токена.

Цена и изменения по ходу работы

Цена на странице окончательная?

Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.

Что означает резерв незапланированных работ?

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

Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.

Можно уточнять детали уже во время работы?

Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.

Начало работы и оплата

Как оформляются договор и оплата?

Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.

Когда начинается срок выполнения?

Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.

Как учитываются платные лицензии и внешние сервисы?

До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.

Проверка результата и гарантия

Как принимается готовая работа?

Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.

Какая гарантия действует после сдачи?

На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.

Связанные шаги

Все услуги по интеграциям