App runtime

Прочитать собственную установку приложения

Отвечает предъявителю, кто он: кабинет, идентичность приложения, действующий набор прав и срок собственного токена. Зовёт эту операцию установка своим токеном, а не человек сессией; людям она отвечает 403.

Кабинета в адресе нет ни одним сегментом. Он берётся из токена, поэтому назвать чужой нечем: заголовок X-Tenant обязателен, но участвует лишь в том, чтобы проверка шла кабинетом, который предъявитель назвал сам, — не совпал с установкой, и ответ тот же, что на неизвестный токен.

Права в ответе — ДЕЙСТВУЮЩИЕ: пересечение одобренного кабинетом, объявленного манифестом текущей версии и записанного в токен при выдаче. Не то, что приложение просило, и не то, на что кабинет когда-то согласился: сужение согласия и обновление приложения действуют на уже выданные токены.

Ради token_expires_at операция и существует в первую очередь: без него рантайм узнаёт об истечении токена только по 401 посреди работы. Людей кабинета ответ не называет — ни того, кто поставил приложение, ни его роли: на доступ установки они не влияют, и знать их приложению незачем.

delivery_endpoint_url — куда Akeda везёт события этой установки. Адрес — свойство установки, а не манифеста, и приложение вправе его прочитать: иначе после переезда сервера оно узнало бы о приёмнике только по тишине. Сменить адрес через этот контур нельзя.

get/api/v1/app/installation

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/app/installation
  • Auth: HTTP bearer

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Response

Личность установки, её права и срок токена

installation_idstring uuid required
status'pending' | 'active' | 'suspended' | 'revoked' required
namespacestring required

Пространство имён приложения app.<издатель>.<ключ> — единственное, в котором оно вправе объявлять свои справочники

publisherstring required
keystring required
versionstring required

Версия, которая стоит у кабинета сейчас; её манифест и режет права

scopesstring[] required

Действующий набор: пересечение одобренного кабинетом, объявленного версией и записанного в токен

delivery_endpoint_urlstring required

Куда Akeda везёт события этой установки. Только чтение: сменить адрес через внешний контур нельзя, это делает персонал платформы по заявке издателя

token_idstring uuid required
token_expires_atstring date-time required

Когда предъявленный токен перестанет работать

Changes

No recorded changes to this operation across all 1 revision of this API.