Интеграция с Zapier

Интеграция с Zapier

Подключите Working Timer к тысячам приложений через Zapier. Например, можно создавать запись рабочего времени из события календаря, формы, строки таблицы или выполненной задачи.

Интеграция использует публичный API Working Timer. Передавать Zapier пароль от Working Timer не требуется.

Что понадобится

  • Аккаунт Working Timer с активным тарифом или пробным периодом Public API
  • Платный тариф Zapier с API by Zapier или Webhooks by Zapier
  • ID профиля Working Timer, в который будут добавляться записи

Важно: Обращайтесь с API-ключом как с паролем. Не добавляйте его в название, заметку, URL или поле Zap, которое может появиться в истории задач.

1. Создание API-ключа

  1. Откройте портал Working Timer API, нажмите Sign In и войдите.
  2. В API Dashboard, в разделе API Keys, нажмите New Key.
  3. Укажите имя, например Zapier, и нажмите Create.
  4. Сразу скопируйте ключ, начинающийся с wt_ak_. Он показывается только один раз.

Если ключ утерян, отзовите его и создайте новый.

2. Поиск ID профиля

  1. Откройте справочник API.
  2. Нажмите Authorize и введите ключ в поле ApiKey.
  3. Откройте GET /api/v1/Profile, нажмите Try it out, затем Execute.
  4. Найдите нужный профиль в ответе и скопируйте его id.

ID имеет формат GUID, например a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Подключение через API by Zapier

  1. В Zapier откройте Apps, нажмите Add connection и выберите API by Zapier.
  2. В Authentication type выберите Static Headers (API key).
  3. В Headers добавьте одну строку:
X-Api-Key: wt_ak_vash_api_klyuch
  1. Укажите Connection name: Working Timer.
  2. Укажите Domain filter: api.workingtimer.com.
  3. В Test URL введите https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Нажмите Yes, Continue to API by Zapier.

API by Zapier находится в бета-версии. Если функция недоступна, используйте способ Webhooks ниже.

4. Создание первого Zap

  1. Создайте Zap и выберите триггер, например новое событие, задачу, форму или строку таблицы.
  2. Добавьте API by Zapier, выберите API Request и подключение Working Timer.
  3. Укажите Method POST и URL https://api.workingtimer.com/api/v1/WorkRecord.
  4. В Body введите:
{
  "profileId": "ID_PROFILYA",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Создано через Zapier"
}
  1. Замените ID_PROFILYA, сопоставьте значения триггера и при необходимости предварительно преобразуйте их через Formatter by Zapier.
  2. Нажмите Test step. Успешный запрос возвращает 201. Проверьте запись в Working Timer и опубликуйте Zap.

clockIn и clockOut — минуты от полуночи: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Для ночной смены clockOut может быть больше 1440.

Альтернатива: Webhooks by Zapier

Добавьте Webhooks by Zapier с событием POST. Укажите URL https://api.workingtimer.com/api/v1/WorkRecord, Payload Type JSON, приведённые выше данные и заголовки X-Api-Key с вашим ключом и Content-Type со значением application/json. Успешный тест возвращает 201.

Другие полезные запросы

  • Профили: GET https://api.workingtimer.com/api/v1/Profile
  • Записи: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Обновление: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Удаление: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Другие endpoints доступны в справочнике API.

Решение проблем

  • 401 Unauthorized — ключ отсутствует, неполный или отозван. Заголовок должен называться точно X-Api-Key.
  • 403 Forbidden — активируйте или продлите тариф либо пробный период Public API.
  • 400 Bad Request — проверьте JSON, дату и числовые значения минут.
  • Profile was not found — убедитесь, что profileId принадлежит тому же аккаунту.
  • 429 Too Many Requests — достигнут лимит API; повторите позже и проверьте использование.
  • Дубликаты — проверьте историю Zapier и добавьте перед действием фильтр или уникальный ID источника.

Чтобы закрыть доступ, нажмите Revoke у ключа Zapier в API Dashboard.