Лента компании

Разделы: auto — сделано автоматически, decision — требует решения, question — вопросы от ИИ. Свежие сверху. Событие может появиться в базе позже более нового (время ставится до записи), то есть ниже уже виденного верха страницы. Опрашивая ленту за новым, читайте страницы, пока не дойдёте до событий на 30 с старше самого нового из виденных, и отсекайте повторы по id (событие с виденным id заменяет прежнее). Проще — поток …/feed/events с once=1 и курсором: он сам отдаёт это окно заново.

Доступ: company.read.

Доступно по ключу API.

GET /v1/companies/{co}/feed

Лента компании

cURL

curl --request GET \
  --url https://api.tungo.kz/v1/companies/{co}/feed \
  --cookie tungo.session_token=

200

{
  "data": [
    {
      "id": "<string>",
      "cursor": "<string>",
      "section": "auto",
      "section_title": "<string>",
      "at": "2023-11-07T05:31:56Z",
      "title": "Реализация товаров и услуг №0000-000123 записан и сверен",
      "actions": [
        {
          "action": "open",
          "label": "<string>",
          "method": "GET",
          "href": "<string>",
          "enabled": true,
          "hint": "<string>",
          "body": {
            "batch_id": "bat_01jz8x3m4n5p6q7r8s9t0v1w2x",
            "post": true
          }
        }
      ],
      "detail": "<string>",
      "proposal_id": "<string>",
      "dialog_id": "<string>",
      "batch_id": "<string>",
      "status": "previewed",
      "status_title": "<string>",
      "amount": {
        "amount": 1234.5,
        "amount_tiyn": 123450,
        "formatted": "1 234,50 ₸"
      },
      "actor": "<string>",
      "actor_name": "<string>"
    }
  ],
  "next_cursor": "aud_01jz8x3m4n5p6q7r8s9t0v1w2x",
  "counts": {
    "auto": 123,
    "decision": 123,
    "question": 123
  },
  "sections": {
    "auto": "Сделано автоматически",
    "decision": "Требует решения",
    "question": "Вопросы от ИИ"
  }
}

Авторизации

sessionapiKeybearerKey

tungo.session_token · string · cookie · обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

co · string · обязательно

id компании, co_… — из GET /v1/companies

Параметры запроса

section · enum<string>

Только этот раздел; без него — все Раздел ленты: auto — «Сделано автоматически» (записано в 1С, проверки учёта без серьёзных находок); decision — «Требует решения» (ждёт одобрения, выписка дня); question — «Вопросы от ИИ» (блокеры, вопросы, сбои автоматизаций)

Доступные опции: auto, decision, question

limit · integer

Сколько на странице: 1–100, по умолчанию 20

Требуемый диапазон: 1 <= x <= 100

cursor · string

next_cursor из ответа прошлой страницы; без него — первая (самая свежая) страница. Остальные фильтры — те же, что у первой страницы.

Ответ

200

application/json

Страница ленты

Страница ленты, свежие сверху

data · object[] · обязательно

Карточки ленты, свежие сверху

Show child attributes

next_cursor · string | null · обязательно

Курсор следующей страницы. Чтобы получить её — тот же запрос (с теми же фильтрами) и ?cursor=<это значение>. null — страниц больше нет (кнопку «Ещё» спрятать). Курсор непрозрачный: не разбирать и не собирать самому, хранить только до следующего запроса. Пустой data с не-null курсором не бывает.

Пример:

"aud_01jz8x3m4n5p6q7r8s9t0v1w2x"

counts · object · обязательно

Размеры разделов целиком (для бейджей), без учёта курсора и фильтра

Show child attributes

sections · object · обязательно

Названия разделов по-русски — для вкладок

Show child attributes