Обзор для разработчиков

Страница Developer открывает доступ к документации API Shifton и инструментам для создания пользовательских интеграций.

Пошаговые инструкции

Доступ к странице Developer

На левой боковой панели нажмите Интеграции.

Перейдите на страницу Разработчик.

В верхней части — три вкладки: Сводка, Вебхуки и Заявки.

Использование вкладки Overview

Ссылка	Описание
Новая документация	Актуальная документация API
Старая документация	Устаревшая документация для существующих интеграций

Нажмите нужную ссылку — документация откроется в новой вкладке.

Другие вкладки Developer

Вебхуки

mdash; настройте конечные точки для уведомлений о событиях в реальном времени.

Заявки

mdash; создавайте пользовательские приложения и управляйте ими.

Связанные статьи

Часто задаваемые вопросы

В: Какую документацию использовать — новую или старую?
Используйте Новая документация для всех новых интеграций. Старая — только для обратной совместимости.

В: Страница Разработчик не отображается — почему?
Страница доступна только Owner.

В: Есть ли ограничения на количество запросов к API?
Да. Подробности — в документации API.

В: Где найти API-ключ для работы с Shifton API?
Integrations → Разработчик → Заявки → создайте приложение → в настройках получите API credentials.

В: Поддерживает ли Shifton OAuth 2.0?
Да. Авторизация через OAuth используется для подключения сторонних приложений. Подробности в документации API.

В: Можно ли тестировать API без создания приложения?
Да — используйте инструменты типа Postman с вашими учётными данными. Для продакшена рекомендуется зарегистрировать приложение.

В: В чём разница между New и Старая документация?
Новая документация — актуальная (рекомендуется для всех новых интеграций). Старая документация — для обратной совместимости с существующими интеграциями.

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

В: Вебхуки поддерживают все типы событий Shifton?
Нет, только определённые. Список поддерживаемых событий — в разделе Developer → Webhooks документации.

В: Нужны ли технические знания для работы с API?
Да. Для работы с REST API и создания интеграций через Applications необходимы базовые навыки разработки.

В: API платный или входит в подписку?
API доступен в рамках подписки без дополнительной платы. Ограничения зависят от тарифного плана.

В: Как получить поддержку при проблемах с интеграцией через API?
Обратитесь в поддержку Shifton с описанием запроса, ответа и кода ошибки. Также изучите документацию на странице Developer.

В: Какой базовый URL для API Shifton?
Базовый URL — api2.shifton.com. Подробности и примеры запросов доступны в Новая документация.

В: Поддерживает ли API пагинацию при запросе больших списков?
Да. Подробности реализации пагинации описаны в документации API.

В: Можно ли через API создавать и удалять смены?
Да. API предоставляет полный CRUD-доступ к сменам, сотрудникам, расписаниям и другим ресурсам.

В: Есть ли sandbox-среда для тестирования API?
Специальной sandbox-среды нет. Рекомендуется создать тестовую компанию в Shifton для безопасного тестирования.

В: Какие форматы данных поддерживает API?
API использует формат JSON для запросов и ответов.