Контекст пользователя

Список членств

Метод возвращает список членств текущего пользователя в организациях с активными ролями и консолидированным списком разрешений.

Это основной способ узнать organisationId для остальных методов API — краткая инструкция в разделе Получение ID организации.

Запрос

Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/me/memberships

У метода нет path-параметров.

Пример запроса

curl --location "https://b2b.selfwork.ru/openapi/v2/me/memberships" \
--header "accept: application/json" \
--header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "result": [
    {
      "organisation": {
        "id": "01961a2b-3c4d-7e5f-8a9b-0c1d2e3f4a5b",
        "name": "ООО Рога и Копыта"
      },
      "roles": [
        {
          "id": "01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b",
          "memberId": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
          "roleId": "019d06af-5e5d-7313-b8ba-df1640767435",
          "roleCode": "OWNER",
          "roleName": "Владелец",
          "active": true,
          "createdAt": "2026-03-17T12:00:00Z"
        }
      ],
      "permissions": ["org.read", "org.update"],
      "joinedAt": "2026-03-17T12:00:00Z"
    }
  ],
  "success": true
}

Описание полей ответа

Поле	Описание
requestId	Уникальный идентификатор запроса
result	Массив членств пользователя
success	Статус выполнения запроса

Объект членства (result[])

Поле	Тип	Описание
organisation	object	Организация
roles	array	Активные роли в организации
permissions	array[string]	Консолидированный список разрешений по всем ролям
joinedAt	string	Дата вступления в организацию

Объект организации (organisation)

Поле	Тип	Описание
id	string	Идентификатор организации
name	string	Название организации

Объект роли (roles[])

Поле	Тип	Описание
id	string (uuid)	Идентификатор назначения
memberId	string (uuid)	Идентификатор членства
roleId	string (uuid)	Идентификатор роли
roleCode	string	Технический код роли
roleName	string	Человекочитаемое название роли
active	boolean	Активность назначения
createdAt	string	Дата создания

 

Получение контекста в рамках запрошенной организации

Метод возвращает контекст текущего пользователя в рамках запрошенной организации: активные роли и разрешения в текущем контексте.

Запрос

Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/me/organisation/{organisationId}/context

Path Parameters

Параметр	Тип	Обязательный	Описание
organisationId	string (uuid)	Да	Идентификатор организации

Пример запроса

curl --location "https://b2b.selfwork.ru/openapi/v2/me/organisation/550e8400-e29b-41d4-a716-446655440000/context" \
--header "accept: application/json" \
--header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "result": {
    "userId": "550e8400-e29b-41d4-a716-446655440000",
    "organisation": {
      "id": "01961a2b-3c4d-7e5f-8a9b-0c1d2e3f4a5b",
      "name": "ООО Рога и Копыта"
    },
    "roles": [
      {
        "id": "01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b",
        "memberId": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
        "roleId": "019d06af-5e5d-7313-b8ba-df1640767435",
        "roleCode": "OWNER",
        "roleName": "Владелец",
        "active": true,
        "createdAt": "2026-03-17T12:00:00Z"
      }
    ],
    "permissions": ["org.read", "org.update"],
    "updatedAt": "2026-03-17T14:00:00Z"
  },
  "success": true
}

Описание полей ответа

Поле	Описание
requestId	Уникальный идентификатор запроса
result	Контекст пользователя
success	Статус выполнения запроса

Контекст пользователя (result)

Поле	Тип	Описание
userId	string	Идентификатор пользователя
organisation	object	Организация текущего контекста
roles	array	Активные роли в текущей организации
permissions	array[string]	Разрешения в текущем контексте
updatedAt	string	Дата последнего переключения (опционально)

Объект организации (organisation)

Поле	Тип	Описание
id	string	Идентификатор организации
name	string	Название организации

Объект роли (roles[])

Поле	Тип	Описание
id	string (uuid)	Идентификатор назначения
memberId	string (uuid)	Идентификатор членства
roleId	string (uuid)	Идентификатор роли
roleCode	string	Технический код роли
roleName	string	Человекочитаемое название роли
active	boolean	Активность назначения
createdAt	string	Дата создания