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

Интеграция YouGile API v2 и переход с v1

Переход с API v1 на API v2 затрагивает авторизацию, структуру данных, права ключа, пагинацию и вебхуки. Поэтому простой замены адресов запросов недостаточно: могут появиться пропуски, дубли и ошибки доступа. Сначала мы определяем, какие вызовы реально использует интеграция и за какие действия они отвечают.

Затем переносим эти сценарии на API v2, учитываем актуальные лимиты и проверяем результат на контрольных данных. Рабочий маршрут переключаем после сверки: создание и обновление задач, поля, пользователи и события должны продолжить работать привычным для команды образом.

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

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

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

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

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

Собираем методы, поля, события и фоновые задания действующей интеграции YouGile API v1.

Проверяем актуальную документацию API v2 и готовим карту соответствия ресурсов и операций.

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

Запускаем одинаковые бизнес-сценарии через старую и новую версии и сравниваем значимые поля.

Фиксируем позицию очереди, включаем API v2 и наблюдаем первые рабочие операции.

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

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

Собираем методы YouGile API v1, которые реально вызывает интеграция, и связываем каждый вызов с рабочим действием. Готовим карту v1→v2, обновляем авторизацию, запросы, ответы, пагинацию, вебхуки и обработку действующих ограничений API. Затем запускаем контрольные сценарии и переключаем рабочий обмен.

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

Материалы

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

Обновлённый модуль интеграции YouGile API v2 с конфигурацией и обработкой ошибок.
Карта соответствия методов и бизнес-сценариев API v1 и API v2.
Контрактные проверки основных операций и журнал контрольного переключения.
Инструкция по ключу, очереди, диагностике ошибки и повторной обработке.

Проверка

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

Каждый выбранный сценарий выполняется через API v2 и создаёт ожидаемый объект либо изменение в YouGile.
Массовая операция проходит через очередь без потери элементов и сохраняет результат каждого запроса.
Контрольные данные по значимым полям совпадают с ожидаемым поведением старой интеграции.
Вебхук или фоновое получение изменений связывает событие с нужным объектом и исключает повторную обработку.

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

Схема перехода интеграции YouGile с REST API v1 на API v2

Заявка из CRM создаёт задачу на доске YouGile

CRM создаёт задачу YouGile, записывает исполнителя и срок, а последующее изменение статуса возвращает его в карточку заявки. Старая интеграция использует методы API v1 и хранит идентификатор задачи в CRM.

01
Находим вызовы создания задачи, выбора доски, назначения пользователя и чтения изменений статуса.
02
Связываем их с ресурсами API v2 и готовим ключ служебного аккаунта с нужными правами.
03
Создаём контрольную заявку, сравниваем поля задачи и проверяем обратное изменение статуса.
04
Останавливаем старую очередь, включаем новый маршрут и сверяем первые рабочие идентификаторы.

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

От вас

Исходный код, конфигурация и журналы действующей интеграции YouGile API v1.
Административный доступ к тестовой и рабочей компании YouGile для создания ключа API v2.
Доступ ко второй системе, примеры объектов, критичные сценарии и удобное окно переключения.

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

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

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

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

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

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

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

Достаточно заменить адрес API v1 на API v2?

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

Какие сценарии можно сохранить при переходе?

Сначала фиксируем действия действующей интеграции: проекты, доски, задачи, пользователи, поля, комментарии и события. Для каждого сценария подбираем официальный маршрут API v2 и проверяем его на контрольном объекте.

Как создаётся ключ YouGile API v2?

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

Как учитываются ограничения частоты запросов?

Актуальный лимит проверяем по официальной документации и ответам API. Запросы проходят через очередь, массовые операции используют пагинацию, а временное ограничение получает запланированный повтор.

Что происходит с вебхуками?

Сверяем доступные события API v2, обновляем обработчик и проверяем подпись, идентификаторы и защиту от повторной обработки. Контрольное событие должно изменить ровно один связанный объект.

Как поступаем с функцией без прямого аналога?

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

Потребуется остановка рабочей интеграции?

Основная разработка и проверка проходят на тестовых объектах. Для переключения согласуем короткое окно: фиксируем позицию очереди, завершаем старые операции, включаем API v2 и выполняем контрольный сценарий.

Как подтвердим сохранность поведения интеграции?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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