tungo-sdk 0.2.0

data/lib/tungo/models/automation_filter_condition.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Одно условие фильтра: значение поля из тела события сравнивается с value.
+    class AutomationFilterCondition < Tungo::Model
+      # @!attribute [r] op
+      #   Как сравнивать значение поля с value. `eq` — равно (строки — без учёта регистра и пробелов по
+      #   краям; числа — как числа, строка «15000.00» равна 15000); `ne` — не равно, или поля нет; `in`
+      #   — равно одному из значений списк…
+      #   @return [String]
+      required :op, :AutomationFilterConditionOp
+
+      # @!attribute [r] path
+      #   Где в JSON тела события взять значение: имена полей через точку, до 10 уровней; элемент
+      #   массива — его номером с нуля (`items.0.sum`).
+      #   @return [String]
+      required :path, :string
+
+      # @!attribute [r] value
+      #   С чем сравнивать: строка (до 500 знаков), число, true/false или null. Для `in` — список до 50
+      #   таких значений; для `gt`/`gte`/`lt`/`lte` — число; для остальных — одно значение. Для `exists`
+      #   не нужно (false — проверить, чт…
+      #   @return [Object]
+      optional :value, :AutomationFilterConditionValue, nullable: true
+    end
+  end
+end

data/lib/tungo/models/automation_filter_condition_op.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Как сравнивать значение поля с value. `eq` — равно (строки — без учёта регистра и пробелов по краям;
+    # числа — как числа, строка «15000.00» равна 15000); `ne` — не равно, или поля нет; `in` — равно
+    # одному из значений списк…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationFilterConditionOp
+      extend Tungo::Internal::Enum
+
+      EQ = "eq"
+      NE = "ne"
+      IN = "in"
+      CONTAINS = "contains"
+      EXISTS = "exists"
+      GT = "gt"
+      GTE = "gte"
+      LT = "lt"
+      LTE = "lte"
+    end
+  end
+end

data/lib/tungo/models/automation_filter_condition_value.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # С чем сравнивать: строка (до 500 знаков), число, true/false или null. Для `in` — список до 50 таких
+    # значений; для `gt`/`gte`/`lt`/`lte` — число; для остальных — одно значение. Для `exists` не нужно
+    # (false — проверить, чт…
+    #
+    # The value is returned as it is.
+    module AutomationFilterConditionValue
+      extend Tungo::Internal::Union
+
+      variants(
+        :string,
+        :number,
+        :boolean,
+        array_of(:AutomationFilterConditionValueOption4Item)
+      )
+    end
+  end
+end

data/lib/tungo/models/automation_filter_condition_value_option4_item.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # The +AutomationFilterConditionValueOption4Item+ union of the API contract.
+    #
+    # The value is returned as it is.
+    module AutomationFilterConditionValueOption4Item
+      extend Tungo::Internal::Union
+
+      variants(
+        :string,
+        :number,
+        :boolean
+      )
+    end
+  end
+end

data/lib/tungo/models/automation_hook.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Входящий хук: адрес, на который сторонний сервис (банк, эквайринг, CRM) шлёт события, запускающие
+    # сценарии.
+    class AutomationHook < Tungo::Model
+      # @!attribute [r] created_at
+      #   Когда заведён, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] enabled
+      #   false — хук выключен: события на его адрес получают 404, как на неизвестный
+      #   @return [Boolean]
+      required :enabled, :boolean
+
+      # @!attribute [r] id
+      #   id хука — для адресов …/automations/hooks/{id} и для trigger.hook_id сценария (hk_…)
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] id_path
+      #   Путь через точку к id события в JSON тела (номер платежа у отправителя) — по нему отсеиваются
+      #   повторы. null — id из заголовков Idempotency-Key / X-Event-Id или хеш тела
+      #   @return [String, nil]
+      required :id_path, :string, nullable: true
+
+      # @!attribute [r] name
+      #   Название хука для людей
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] scenarios_url
+      #   Путь API к сценариям компании: сценарии этого хука — те, у которых trigger.hook_id равен id
+      #   хука
+      #   @return [String]
+      required :scenarios_url, :string
+
+      # @!attribute [r] signature_header
+      #   Заголовок, в котором отправитель присылает подпись (нижним регистром)
+      #   @return [String]
+      required :signature_header, :string
+
+      # @!attribute [r] signed
+      #   Задан ли секрет подписи: true — события без верной подписи отвергаются (401). Сам секрет не
+      #   показывается никогда. По событиям хука без подписи автоодобрение ничего в 1С не пишет
+      #   @return [Boolean]
+      required :signed, :boolean
+
+      # @!attribute [r] token_hint
+      #   Последние 4 знака токена после многоточия — узнать, какой адрес настроен у отправителя. Сам
+      #   токен не хранится: потерян — POST …/hooks/{id}/rotate
+      #   @return [String]
+      required :token_hint, :string
+
+      # @!attribute [r] updated_at
+      #   Когда менялся последний раз, ISO 8601 UTC
+      #   @return [String]
+      required :updated_at, :string
+    end
+  end
+end

data/lib/tungo/models/automation_hook_accepted.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ответ приёма события.
+    class AutomationHookAccepted < Tungo::Model
+      # @!attribute [r] accepted
+      #   Всегда true — событие принято
+      #   @return [Boolean]
+      required :accepted, :boolean
+
+      # @!attribute [r] duplicate
+      #   true — это событие уже принято раньше (тот же id отправителя), второй раз сценарии не
+      #   запускаются
+      #   @return [Boolean]
+      required :duplicate, :boolean
+
+      # @!attribute [r] event_id
+      #   id события у нас: по нему запуски находятся в журнале — GET …/automations/runs?event_id=
+      #   (hev_…)
+      #   @return [String]
+      required :event_id, :string
+
+      # @!attribute [r] run_ids
+      #   Запуски, поставленные этим событием (в очереди, ещё не выполнены): статус — GET
+      #   …/automations/runs/{id}, итог — вебхуки automation.run.completed / automation.run.failed с тем
+      #   же run_id. У повтора — те же запуски, что пос…
+      #   @return [Array<String>]
+      required :run_ids, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/automation_hook_create.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Новый хук.
+    class AutomationHookCreate < Tungo::Model
+      # @!attribute [r] id_path
+      #   Путь через точку к id события в JSON тела — номер платежа или чека у отправителя. Задан и поле
+      #   есть — повтор с тем же id считается тем же событием, даже с новым Idempotency-Key. null или
+      #   нет — id берётся из заголовка Ide…
+      #   @return [String, nil]
+      optional :id_path, :string, nullable: true
+
+      # @!attribute [r] name
+      #   Название хука для людей (1–200 знаков): откуда приходят события.
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] signature_header
+      #   Имя заголовка с подписью: латиница, цифры, дефис, до 64 знаков; приводится к нижнему регистру.
+      #   Не передан при заведении — `x-signature`.
+      #   @return [String, nil]
+      optional :signature_header, :string
+
+      # @!attribute [r] signature_secret
+      #   Секрет подписи (16–500 знаков), общий с отправителем. Задан — каждое событие обязано нести в
+      #   заголовке signature_header HMAC-SHA256(секрет, сырое тело) в hex (можно с приставкой
+      #   `sha256=`), иначе приём отвечает 401. Хран…
+      #   @return [String, nil]
+      optional :signature_secret, :string, nullable: true
+
+      # Credentials: #inspect shows [REDACTED] instead of their values.
+      sensitive "signature_secret"
+    end
+  end
+end

data/lib/tungo/models/automation_hook_event.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Событие, запустившее сценарий: принятое хуком или событие внутри Tungo.
+    class AutomationHookEvent < Tungo::Model
+      # @!attribute [r] body
+      #   Тело события как пришло: текст (обычно JSON строкой — разобрать JSON.parse) или base64 при
+      #   encoding = base64
+      #   @return [String]
+      required :body, :string
+
+      # @!attribute [r] content_type
+      #   Заголовок Content-Type запроса отправителя; null — его не было
+      #   @return [String, nil]
+      required :content_type, :string, nullable: true
+
+      # @!attribute [r] encoding
+      #   Как хранится body: `utf8` — текст как пришёл; `base64` — тело не текст UTF-8, хранится в
+      #   base64
+      #   @return [String]
+      required :encoding, :AutomationHookEventEncoding
+
+      # @!attribute [r] external_id
+      #   id события у отправителя (до 200 знаков): из тела по id_path хука, из заголовка
+      #   Idempotency-Key или X-Event-Id, иначе sha256 тела. По нему отсеиваются повторы
+      #   @return [String, nil]
+      required :external_id, :string, nullable: true
+
+      # @!attribute [r] hook_id
+      #   Хук, на который пришло событие; null — событие Tungo (source = tungo) (hk_…)
+      #   @return [String, nil]
+      required :hook_id, :string, nullable: true
+
+      # @!attribute [r] id
+      #   id события у нас — у хука тот же event_id, что вернул приём (hev_…)
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] received_at
+      #   Когда событие принято, ISO 8601 UTC
+      #   @return [String]
+      required :received_at, :string
+
+      # @!attribute [r] size
+      #   Размер тела в байтах
+      #   @return [Integer]
+      required :size, :integer
+
+      # @!attribute [r] source
+      #   `hook` — событие пришло на хук; `tungo` — событие внутри Tungo (тело — как у вебхука этого
+      #   события)
+      #   @return [String]
+      required :source, :AutomationHookEventSource
+
+      # @!attribute [r] type
+      #   Вид события Tungo (esf.incoming.received, …); у хука — null
+      #   @return [String, nil]
+      required :type, :string, nullable: true
+    end
+  end
+end

data/lib/tungo/models/automation_hook_event_encoding.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Как хранится body: `utf8` — текст как пришёл; `base64` — тело не текст UTF-8, хранится в base64
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationHookEventEncoding
+      extend Tungo::Internal::Enum
+
+      UTF8 = "utf8"
+      BASE64 = "base64"
+    end
+  end
+end

data/lib/tungo/models/automation_hook_event_source.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # `hook` — событие пришло на хук; `tungo` — событие внутри Tungo (тело — как у вебхука этого события)
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationHookEventSource
+      extend Tungo::Internal::Enum
+
+      HOOK = "hook"
+      TUNGO = "tungo"
+    end
+  end
+end

data/lib/tungo/models/automation_hook_patch.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Изменение хука: меняются только переданные поля.
+    class AutomationHookPatch < Tungo::Model
+      # @!attribute [r] enabled
+      #   false — выключить: события на адрес хука получают 404, как на неизвестный. Включить хук,
+      #   питающий сценарий с автоодобрением, может только тот, у кого есть proposals.approve.
+      #   @return [Boolean, nil]
+      optional :enabled, :boolean
+
+      # @!attribute [r] id_path
+      #   Путь через точку к id события в JSON тела — номер платежа или чека у отправителя. Задан и поле
+      #   есть — повтор с тем же id считается тем же событием, даже с новым Idempotency-Key. null или
+      #   нет — id берётся из заголовка Ide…
+      #   @return [String, nil]
+      optional :id_path, :string, nullable: true
+
+      # @!attribute [r] name
+      #   Название хука для людей (1–200 знаков): откуда приходят события.
+      #   @return [String, nil]
+      optional :name, :string
+
+      # @!attribute [r] signature_header
+      #   Имя заголовка с подписью: латиница, цифры, дефис, до 64 знаков; приводится к нижнему регистру.
+      #   Не передан при заведении — `x-signature`.
+      #   @return [String, nil]
+      optional :signature_header, :string
+
+      # @!attribute [r] signature_secret
+      #   Секрет подписи (16–500 знаков), общий с отправителем. Задан — каждое событие обязано нести в
+      #   заголовке signature_header HMAC-SHA256(секрет, сырое тело) в hex (можно с приставкой
+      #   `sha256=`), иначе приём отвечает 401. Хран…
+      #   @return [String, nil]
+      optional :signature_secret, :string, nullable: true
+
+      # Credentials: #inspect shows [REDACTED] instead of their values.
+      sensitive "signature_secret"
+    end
+  end
+end

data/lib/tungo/models/automation_hook_test_input.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Пробное событие хука.
+    class AutomationHookTestInput < Tungo::Model
+      # @!attribute [r] body
+      #   Тело события, как его пришлёт отправитель: любое значение JSON (объект, массив, число…) — оно
+      #   берётся как JSON-текст; строка — как сырой текст тела (так можно проверить и тело не-JSON). Не
+      #   больше hook_body_max_bytes.
+      #   @return [Object]
+      required :body, :any
+
+      # @!attribute [r] content_type
+      #   Content-Type, с которым пришло бы событие (по умолчанию application/json) — сохраняется у
+      #   пробного события и виден ИИ.
+      #   @return [String, nil]
+      optional :content_type, :string
+
+      # @!attribute [r] run
+      #   true — сохранить событие как пробное и поставить пробные запуски подошедшим включённым
+      #   сценариям (ИИ вызывается и стоит как обычно; в 1С само ничего не пишется). Нет или false —
+      #   только разбор: ничего не сохраняется, ИИ н…
+      #   @return [Boolean, nil]
+      optional :run, :boolean
+    end
+  end
+end

data/lib/tungo/models/automation_hook_test_result.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Разбор пробного события хука.
+    class AutomationHookTestResult < Tungo::Model
+      # @!attribute [r] event_id
+      #   Пробное событие (hev_…) — только при run: true; null — ничего не сохранено
+      #   @return [String, nil]
+      required :event_id, :string, nullable: true
+
+      # @!attribute [r] external_id
+      #   Номер операции, который взяла бы настоящая доставка (до 200 знаков)
+      #   @return [String]
+      required :external_id, :string
+
+      # @!attribute [r] external_id_note
+      #   То же словами: откуда настоящая доставка возьмёт номер операции
+      #   @return [String]
+      required :external_id_note, :string
+
+      # @!attribute [r] external_id_source
+      #   Откуда он взят: `id_path` — из поля тела по id_path хука; `body_hash` — sha256 тела (поля по
+      #   id_path нет); у настоящей доставки без id_path первыми идут заголовки Idempotency-Key и
+      #   X-Event-Id
+      #   @return [String]
+      required :external_id_source, :AutomationHookTestResultExternalIdSource
+
+      # @!attribute [r] hook_id
+      #   Хук (hk_…)
+      #   @return [String]
+      required :hook_id, :string
+
+      # @!attribute [r] json
+      #   Разобралось ли тело как JSON (фильтр видит только JSON)
+      #   @return [Boolean]
+      required :json, :boolean
+
+      # @!attribute [r] run_ids
+      #   Пробные запуски подошедших включённых сценариев (run: true); пусто без run
+      #   @return [Array<String>]
+      required :run_ids, array_of(:string)
+
+      # @!attribute [r] scenarios
+      #   Сценарии с триггером этого хука и что с каждым
+      #   @return [Array<Tungo::Models::AutomationHookTestScenario>]
+      required :scenarios, array_of(:AutomationHookTestScenario)
+
+      # @!attribute [r] signature_note
+      #   Что с подписью у настоящих событий — словами
+      #   @return [String]
+      required :signature_note, :string
+
+      # @!attribute [r] signed
+      #   true — хук требует подписи: настоящее событие без верной подписи получит 401. Здесь подпись не
+      #   проверялась
+      #   @return [Boolean]
+      required :signed, :boolean
+    end
+  end
+end

data/lib/tungo/models/automation_hook_test_result_external_id_source.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Откуда он взят: `id_path` — из поля тела по id_path хука; `body_hash` — sha256 тела (поля по id_path
+    # нет); у настоящей доставки без id_path первыми идут заголовки Idempotency-Key и X-Event-Id
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationHookTestResultExternalIdSource
+      extend Tungo::Internal::Enum
+
+      ID_PATH = "id_path"
+      IDEMPOTENCY_KEY = "idempotency_key"
+      X_EVENT_ID = "x_event_id"
+      BODY_HASH = "body_hash"
+    end
+  end
+end

data/lib/tungo/models/automation_hook_test_scenario.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Сценарий хука и пробное тело: подошёл ли.
+    class AutomationHookTestScenario < Tungo::Model
+      # @!attribute [r] enabled
+      #   Включён ли сценарий: выключенный настоящее событие не запустит
+      #   @return [Boolean]
+      required :enabled, :boolean
+
+      # @!attribute [r] failed_condition
+      #   Первое невыполненное условие фильтра; null — все выполнены (или тело не JSON — тогда смотрите
+      #   reason)
+      #   @return [Tungo::Models::AutomationHookTestScenarioFailedCondition, nil]
+      required :failed_condition, :AutomationHookTestScenarioFailedCondition, nullable: true
+
+      # @!attribute [r] matched
+      #   Подходит ли тело фильтру сценария
+      #   @return [Boolean]
+      required :matched, :boolean
+
+      # @!attribute [r] name
+      #   Название сценария
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] reason
+      #   Почему сценарий не запустится — словами; null — запустится
+      #   @return [String, nil]
+      required :reason, :string, nullable: true
+
+      # @!attribute [r] scenario_id
+      #   Сценарий этого хука (scn_…)
+      #   @return [String]
+      required :scenario_id, :string
+
+      # @!attribute [r] would_run
+      #   Запустит ли настоящее событие с таким телом этот сценарий: подходит и сценарий включён
+      #   @return [Boolean]
+      required :would_run, :boolean
+    end
+  end
+end

data/lib/tungo/models/automation_hook_test_scenario_failed_condition.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Первое невыполненное условие фильтра; null — все выполнены (или тело не JSON — тогда смотрите
+    # reason)
+    class AutomationHookTestScenarioFailedCondition < Tungo::Model
+      # @!attribute [r] index
+      #   Номер условия в trigger.filter.all, с нуля
+      #   @return [Integer]
+      required :index, :integer
+
+      # @!attribute [r] op
+      #   op этого условия
+      #   @return [String]
+      required :op, :string
+
+      # @!attribute [r] path
+      #   path этого условия
+      #   @return [String]
+      required :path, :string
+    end
+  end
+end

data/lib/tungo/models/automation_hook_with_token.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Хук с токеном — ответ на заведение и смену токена; токен больше нигде не показывается.
+    class AutomationHookWithToken < Tungo::Model
+      # @!attribute [r] created_at
+      #   Когда заведён, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] enabled
+      #   false — хук выключен: события на его адрес получают 404, как на неизвестный
+      #   @return [Boolean]
+      required :enabled, :boolean
+
+      # @!attribute [r] id
+      #   id хука — для адресов …/automations/hooks/{id} и для trigger.hook_id сценария (hk_…)
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] id_path
+      #   Путь через точку к id события в JSON тела (номер платежа у отправителя) — по нему отсеиваются
+      #   повторы. null — id из заголовков Idempotency-Key / X-Event-Id или хеш тела
+      #   @return [String, nil]
+      required :id_path, :string, nullable: true
+
+      # @!attribute [r] name
+      #   Название хука для людей
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] scenarios_url
+      #   Путь API к сценариям компании: сценарии этого хука — те, у которых trigger.hook_id равен id
+      #   хука
+      #   @return [String]
+      required :scenarios_url, :string
+
+      # @!attribute [r] signature_header
+      #   Заголовок, в котором отправитель присылает подпись (нижним регистром)
+      #   @return [String]
+      required :signature_header, :string
+
+      # @!attribute [r] signed
+      #   Задан ли секрет подписи: true — события без верной подписи отвергаются (401). Сам секрет не
+      #   показывается никогда. По событиям хука без подписи автоодобрение ничего в 1С не пишет
+      #   @return [Boolean]
+      required :signed, :boolean
+
+      # @!attribute [r] token
+      #   Токен хука (th_…, 46 знаков) — только в этом ответе: сохраните у отправителя. Кто знает токен,
+      #   может слать события этой компании. null — повтор запроса с тем же Idempotency-Key: токен уже
+      #   выдан первым ответом (token_note…
+      #   @return [String, nil]
+      required :token, :string, nullable: true
+
+      # @!attribute [r] token_hint
+      #   Последние 4 знака токена после многоточия — узнать, какой адрес настроен у отправителя. Сам
+      #   токен не хранится: потерян — POST …/hooks/{id}/rotate
+      #   @return [String]
+      required :token_hint, :string
+
+      # @!attribute [r] token_note
+      #   Только в повторе с тем же Idempotency-Key: почему token и url — null и что делать (rotate)
+      #   @return [String, nil]
+      optional :token_note, :string
+
+      # @!attribute [r] updated_at
+      #   Когда менялся последний раз, ISO 8601 UTC
+      #   @return [String]
+      required :updated_at, :string
+
+      # @!attribute [r] url
+      #   Полный адрес приёма событий (адрес API + `/hooks/{token}`) — его и дают отправителю. null —
+      #   повтор с тем же Idempotency-Key
+      #   @return [String, nil]
+      required :url, :string, nullable: true
+
+      # Credentials: #inspect shows [REDACTED] instead of their values.
+      sensitive "token", "url"
+    end
+  end
+end