Войти

Strata API

Заказы, списанное время и аналитика воркспейса Strata. API только читает данные. Время — в секундах, суммы — целыми числами в сотых долях валюты воркспейса, моменты — ISO 8601 в UTC.

Выпустить токенФайл OpenAPI
Содержание

Как подключиться

  1. В Strata откройте «Настройки → API» и выпустите токен. Он показывается один раз, поэтому сохраните его сразу.
  2. Передавайте токен в заголовке Authorization каждого запроса.
  3. Проверьте подключение запросом к /me. В ответе придут воркспейс, автор токена и лимиты.
curl https://stratahq.pro/api/v1/me \
  -H "Authorization: Bearer stk_..."

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

Выпускают токены владелец и менеджеры. В воркспейсе может быть до 20 действующих токенов. Срок действия выбирается при выпуске, можно и бессрочно.

Адрес API: https://stratahq.pro/api/v1

Списки по страницам

Списки приходят по страницам. Записи лежат в items, а в nextCursor — метка следующей страницы. Передайте её в параметре cursor, чтобы получить продолжение. Когда nextCursor равен null, записей больше нет. 

{
  "items": [ ... ],
  "nextCursor": "eyJpZCI6NDJ9"
}
curl "https://stratahq.pro/api/v1/tasks?limit=100&cursor=eyJpZCI6NDJ9" \
  -H "Authorization: Bearer stk_..."

Размер страницы задаёт limit: от 1 до 100 записей, по умолчанию 50.

Лимиты

Все токены воркспейса делят один лимит: 300 запросов в минуту. У сводки аналитики лимит свой, 30 запросов в минуту. Запросы без действующего токена ограничены по IP-адресу.

Когда лимит исчерпан, API отвечает статусом 429 с заголовком Retry-After: через столько секунд запрос можно повторить. Лимиты вашего воркспейса приходят в ответе /me.

Ошибки

При ошибке API отвечает статусом 4xx или 5xx и телом в формате application/problem+json. Что случилось, определяйте по полю code: текст в detail может меняться. Со временем могут появиться новые коды, поэтому незнакомый код обрабатывайте по HTTP-статусу. 

{
  "status": 404,
  "title": "Not Found",
  "detail": "Не найдено.",
  "code": "API_NOT_FOUND"
}
API_INVALID_QUERY400

Ошибка в параметрах запроса.

API_TOKEN_INVALID401

Токена нет или он больше не действует.

API_ACCESS_DENIED403

По этому токену такие данные недоступны.

API_NOT_FOUND404

Не найдено.

API_METHOD_NOT_ALLOWED405

API только читает данные — используйте GET.

API_RATE_LIMITED429

Слишком много запросов. Подождите и повторите.

API_INTERNAL_ERROR500

Что-то пошло не так на нашей стороне. Повторите позже.

Токен

Воркспейс, ваш профиль, токен и лимиты

GET/api/v1/me

Ответ:Токен и его воркспейс

Заказы

Список заказов

GET/api/v1/tasks

Сначала давно изменённые. Чтобы забирать только изменения, передайте в updatedSince самое позднее updatedAt из прошлой выгрузки минус 5 минут.

Параметры

updatedSince дата и время

Только заказы, изменённые начиная с этого момента, например 2026-09-30T10:00:00Z. «+» в смещении записывайте как %2B.

status список: строка

Только заказы в этих статусах: status=done&status=cancel или status=done,cancel.

limit число

Сколько записей на странице: от 1 до 100, по умолчанию 50.

cursor строка

nextCursor из предыдущего ответа.

Ответ: страница списка, в items — Заказ

Заказ с описанием и этапами

GET/api/v1/tasks/{idOrKey}

Параметры

idOrKey строка

Id заказа или его номер, например SMCP-42.

Ответ:Заказ с описанием и этапами

Ещё может вернуть 404: Не найдено.

Время

Записи времени

GET/api/v1/worklogs

Сначала ранние.

Параметры

from дата и время

Записи, начатые не раньше этого момента.

to дата и время

Записи, начатые раньше этого момента.

memberId число

Только записи этого сотрудника.

taskId число

Только записи по этому заказу.

limit число

Сколько записей на странице: от 1 до 100, по умолчанию 50.

cursor строка

nextCursor из предыдущего ответа.

Ответ: страница списка, в items — Запись времени

Аналитика

Сводка за период

GET/api/v1/analytics/summary

Время и деньги по командам, видам работ, людям и статусам, сроки. Только по токену владельца, не больше 30 запросов в минуту.

Параметры

from дата

Первый день периода, например 2026-09-01. Без from и to — текущая неделя.

to дата

День после последнего дня периода, например 2026-10-01.

Ответ:Сводка за период

Объекты

Токен и его воркспейс

Кто выпустил токен, сам токен и лимиты запросов.

workspaceВоркспейс
memberАвтор токена
tokenТокен, которым сделан запрос
limitsЛимиты запросов

Заказ

id число
key строка

Номер заказа, как в интерфейсе, например SMCP-42.

name строка
status строка

Статус: draft — черновик, backlog — бэклог, need_clarification — на уточнении, confirmed — подтверждён, in_process — в работе, under_review — на проверке, done — готов, cancel — отменён.

draftin_processbacklogneed_clarificationconfirmedunder_reviewdonecancel

workTypeСсылка на объект

Вид работ.

projectСсылка на объект или null

Проект; null — заказ вне проекта.

clientСсылка на объект или null

Клиент или бренд; у бренда название вместе с клиентом: «Сбер / Маркет». null — клиент не указан.

authorСсылка на объект

Кто создал заказ.

quantity число

Сколько единиц вида работ заказано.

dueDate дата или null

Срок сдачи; null — без срока.

estimatedSeconds число

Оценка по этапам, секунды.

actualSeconds число

Списанное время, секунды.

estimatedCost число

Стоимость по этапам, в сотых долях валюты.

actualCost число или null

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

createdAt дата и время
updatedAt дата и время

Когда заказ меняли в последний раз. Смена исполнителей этапов его не меняет.

statusChangedAt дата и время или null

Когда заказ перешёл в текущий статус; null — статус тот же, что при создании.

completedAt дата и время или null

Когда заказ перешёл в «Готово»; null — ещё не готов.

Заказ с описанием и этапами

taskЗаказ
description строка или null

Описание заказа.

discussLink строка или null

Ссылка на обсуждение заказа вне Strata.

stages список: Этап заказа

Этапы в порядке выполнения.

Запись времени

id число
taskСсылка на заказ
memberСсылка на объект

Кто списал время.

startedAt дата и время
endedAt дата и время или null

Конец записи; null — таймер ещё идёт.

seconds число

Длительность, секунды. У идущего таймера — сколько он идёт на момент ответа.

isRunning да или нет

Идёт ли таймер.

comment строка или null
updatedAt дата и время

Сводка за период

Как на дашборде аналитики: период — с from по день перед to, дни по UTC.

from дата
to дата
totalИтог за период
teams список: Строка разреза

По командам.

workTypes список: Строка разреза

По видам работ.

members список: Строка разреза

По сотрудникам.

statuses список: Заказы в одном статусе

По статусам заказов.

deliveryСроки

Воркспейс

id число
name строка
keyPrefix строка

Префикс номеров заказов, например SMCP.

currency строка или null

Валюта сумм; null — не выбрана. Суммы в ответах — целые числа в сотых долях валюты: копейках, центах.

RUBUSDEURCNY

Автор токена

Запросы идут с его правами.

id число
name строка
role строка

Роль: owner — владелец, manager — менеджер, viewer — наблюдатель.

ownermanagerviewer

Токен, которым сделан запрос

id число
name строка
expiresAt дата и время или null

До какого момента действует токен; null — бессрочный.

Лимиты запросов

Общие для всех токенов воркспейса.

generalЛимит запросов

Все запросы, кроме аналитики.

analyticsЛимит запросов

Запросы сводки аналитики.

Ссылка на объект

Id и название.

id число
name строка

Этап заказа

id число
name строка
position число

Порядок этапа: чем меньше, тем раньше.

teamСсылка на объект или null

Команда этапа; null — не назначена.

assignees список: Ссылка на объект

Исполнители этапа.

seconds число

Оценка этапа, секунды.

cost число

Стоимость этапа, в сотых долях валюты.

executionTaskId число или null

Id подзадачи этапа на доске спринтов; null — этап ещё не в работе.

Ссылка на заказ

Id и номер заказа.

id число
key строка

Итог за период

tasks число

Сколько заказов со списанным за период временем.

plannedSeconds число

Запланированное на период время, секунды.

factSeconds число

Списанное за период время, секунды.

factCost число

Себестоимость списанного времени, в сотых долях валюты.

Строка разреза

Команда, вид работ или сотрудник.

id число

Id команды, вида работ или сотрудника.

name строка
tasks число

Сколько заказов со списанным за период временем.

plannedSeconds число

Запланированное на период время, секунды.

factSeconds число

Списанное за период время, секунды.

factCost число

Себестоимость списанного времени, в сотых долях валюты.

targetSeconds число или null

Оценка тех же заказов, секунды. Есть у команд и видов работ, у сотрудников — null.

targetCost число или null

Стоимость тех же заказов, в сотых долях валюты. Есть у команд и видов работ, у сотрудников — null.

Заказы в одном статусе

status строка

Статус: draft — черновик, backlog — бэклог, need_clarification — на уточнении, confirmed — подтверждён, in_process — в работе, under_review — на проверке, done — готов, cancel — отменён.

draftin_processbacklogneed_clarificationconfirmedunder_reviewdonecancel

tasks число

Сколько заказов в этом статусе, по которым за период списано или запланировано время.

plannedSeconds число

Запланированное на период время, секунды.

factSeconds число

Списанное за период время, секунды.

Сроки

Сколько заказов создано и завершено за период, из них в срок и с опозданием, сколько без срока и сколько просрочено сейчас.

created число
completed число
onTime число
overdue число
noDue число
openOverdue число
averageCycleSeconds число

Сколько в среднем проходит от создания до завершения, секунды.

Лимит запросов

Не больше requests запросов за windowSeconds секунд.

requests число
windowSeconds число