Задача API-интеграции между системами для команды в Санкт-Петербурге
REST, webhooks, OAuth и интеграционные шлюзы для надежного обмена между системами.
Фокус обсуждения: Связать пользовательский путь с внутренней работой команды.
Что обсуждаем на старте
системы, методы, авторизацию, объекты, лимиты, ошибки и владельцев данных.
Что принимаем в результате
контракт API, тестовые запросы, логирование, повторную обработку и правила мониторинга.
Границы и зависимости
доступность стороннего API, лимиты и изменения документации находятся у владельца сервиса.
Координация работы в Санкт-Петербурге
Для интеграционного проекта уточняем владельцев систем, данные и поведение при ошибках; городская координация помогает согласовать эти решения с командой в Санкт-Петербурге. Демонстрации проводим по времени Санкт-Петербурга, UTC+3. Работа ведётся удалённо; OTON не заявляет офис, сотрудников или местное представительство в этом городе.
Вопрос для брифа
Что делает пользователь и кто продолжает процесс внутри?
Передача результата
Проверяем шаги, статусы, исключения и ответственных.
География предложения
До старта уточняем, рассчитано ли предложение на аудиторию в Санкт-Петербурге, на Россию или на несколько рынков. Это влияет на язык, форму, обязательные сведения, аналитику и рекламные настройки; локальные обещания не придумываются.
Локальный контекст
Для обмена между системами на брифе описываем категории данных, получателей, сроки хранения и контроль доступа; правовую схему подтверждает заказчик. Официальный интернет-портал правовой информации.
Городской контекст
Городская система открытых данных публикует сведения исполнительных органов в машиночитаемом формате для загрузки в базы и программные компоненты. До интеграции фиксируем конкретный набор, формат, дату обновления, ключи сопоставления и допустимый способ использования. Приёмка проверяет импорт реального образца, повторный запуск без дублей, обработку изменения схемы и указание источника. Official website of the Saint Petersburg Administration.
Вопрос до брифа
Можно ли подключить закрытое API? Да, если заказчик предоставляет законный доступ и документацию. Нужно заранее описать весь процесс? Нет, достаточно основных шагов и ответственных.