[{"data":1,"prerenderedAt":792},["ShallowReactive",2],{"navigation":3,"\u002Fconcepts\u002Fusers":88,"\u002Fconcepts\u002Fusers-surround":787},[4,21,42,63,83],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":20},"Начало работы","i-lucide-compass","\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Обзор сервиса","\u002Fgetting-started\u002Foverview","1.getting-started\u002F1.overview","i-lucide-book-open",{"title":16,"path":17,"stem":18,"icon":19},"Быстрый старт","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-zap",false,{"title":22,"icon":23,"path":24,"stem":25,"children":26,"page":20},"Аутентификация","i-lucide-key-round","\u002Fauthentication","2.authentication",[27,32,37],{"title":28,"path":29,"stem":30,"icon":31},"OAuth Flow и сессии","\u002Fauthentication\u002Foauth-flow","2.authentication\u002F1.oauth-flow","i-lucide-log-in",{"title":33,"path":34,"stem":35,"icon":36},"JWT и Discovery","\u002Fauthentication\u002Fjwt-and-discovery","2.authentication\u002F2.jwt-and-discovery","i-lucide-file-key-2",{"title":38,"path":39,"stem":40,"icon":41},"API-ключи","\u002Fauthentication\u002Fapi-keys","2.authentication\u002F3.api-keys","i-lucide-key-square",{"title":43,"icon":44,"path":45,"stem":46,"children":47,"page":20},"Доступ и сущности","i-lucide-layers","\u002Fconcepts","3.concepts",[48,53,58],{"title":49,"path":50,"stem":51,"icon":52},"Права доступа","\u002Fconcepts\u002Fpermissions","3.concepts\u002F1.permissions","i-lucide-shield-check",{"title":54,"path":55,"stem":56,"icon":57},"Пользователи","\u002Fconcepts\u002Fusers","3.concepts\u002F2.users","i-lucide-users",{"title":59,"path":60,"stem":61,"icon":62},"Отделы (Departments)","\u002Fconcepts\u002Fdepartments","3.concepts\u002F3.departments","i-lucide-network",{"title":64,"icon":65,"path":66,"stem":67,"children":68,"page":20},"Интеграция","i-lucide-blocks","\u002Fintegration","4.integration",[69,74,78],{"title":70,"path":71,"stem":72,"icon":73},"Пакеты .NET","\u002Fintegration\u002Fdotnet-sdk","4.integration\u002F1.dotnet-sdk","i-lucide-package",{"title":75,"path":76,"stem":77,"icon":73},"Пакет Go","\u002Fintegration\u002Fgo-sdk","4.integration\u002F2.go-sdk",{"title":79,"path":80,"stem":81,"icon":82},"gRPC API","\u002Fintegration\u002Fgrpc","4.integration\u002F3.grpc","i-lucide-server",{"title":84,"path":85,"stem":86,"icon":87},"OpenAPI","\u002Fopenapi","5.openapi","i-lucide-braces",{"id":89,"title":90,"body":91,"description":780,"extension":781,"hideToc":20,"links":782,"meta":783,"navigation":784,"path":55,"seo":785,"stem":56,"wide":20,"__hash__":786},"docs\u002F3.concepts\u002F2.users.md","Пользователи и сессии",{"type":92,"value":93,"toc":770},"minimark",[94,111,116,205,210,307,328,332,398,454,458,467,481,485,505,512,632,642,646,724,742,746,755,766],[95,96,97,98,102,103,106,107,110],"p",{},"Эндпоинты под ",[99,100,101],"code",{},"\u002Fv1\u002Fusers"," позволяют получать публичные и полные профили, обновлять данные и изображения профиля, просматривать права и управлять активными сессиями. Все защищённые маршруты принимают как ",[99,104,105],{},"Bearer"," JWT, так и ",[99,108,109],{},"X-Api-Key",".",[112,113,115],"h2",{"id":114},"получение-профиля","Получение профиля",[117,118,119,138],"table",{},[120,121,122],"thead",{},[123,124,125,129,132,135],"tr",{},[126,127,128],"th",{},"Метод",[126,130,131],{},"Путь",[126,133,134],{},"Авторизация",[126,136,137],{},"Что возвращает",[139,140,141,168,189],"tbody",{},[123,142,143,149,154,165],{},[144,145,146],"td",{},[99,147,148],{},"GET",[144,150,151],{},[99,152,153],{},"\u002Fv1\u002Fusers\u002F@me",[144,155,156,157,160,161,164],{},"JWT \u002F ",[99,158,159],{},"pat"," (",[99,162,163],{},"users.profile:read:self",")",[144,166,167],{},"Полный профиль текущего пользователя",[123,169,170,174,179,182],{},[144,171,172],{},[99,173,148],{},[144,175,176],{},[99,177,178],{},"\u002Fv1\u002Fusers?username=...",[144,180,181],{},"Опциональная",[144,183,184,185,188],{},"Полный профиль владельцу или при наличии ",[99,186,187],{},"users.profile:read",", иначе — публичный профиль",[123,190,191,195,200,202],{},[144,192,193],{},[99,194,148],{},[144,196,197],{},[99,198,199],{},"\u002Fv1\u002Fusers\u002F{uuid}",[144,201,181],{},[144,203,204],{},"То же правило видимости по UUID",[206,207,209],"h3",{"id":208},"публичный-профиль-vs-полный-профиль","Публичный профиль vs полный профиль",[117,211,212,232],{},[120,213,214],{},[123,215,216,219,226],{},[126,217,218],{},"Поле",[126,220,222,223,164],{"align":221},"center","Публичный (",[99,224,225],{},"UserGetResponsePublic",[126,227,228,229,164],{"align":221},"Полный (",[99,230,231],{},"UserGetResponse",[139,233,234,259,280,291],{},[123,235,236,254,257],{},[144,237,238,241,242,241,245,241,248,241,251],{},[99,239,240],{},"id",", ",[99,243,244],{},"username",[99,246,247],{},"avatar",[99,249,250],{},"banner",[99,252,253],{},"groups",[144,255,256],{"align":221},"Да",[144,258,256],{"align":221},[123,260,261,275,278],{},[144,262,263,241,266,241,269,241,272],{},[99,264,265],{},"email",[99,267,268],{},"firstname",[99,270,271],{},"lastname",[99,273,274],{},"middlename",[144,276,277],{"align":221},"—",[144,279,256],{"align":221},[123,281,282,287,289],{},[144,283,284],{},[99,285,286],{},"permissions",[144,288,277],{"align":221},[144,290,256],{"align":221},[123,292,293,298,300],{},[144,294,295],{},[99,296,297],{},"departments",[144,299,277],{"align":221},[144,301,302,303],{"align":221},"Да ",[304,305,306],"em",{},"(для чужого профиля отфильтровано по правилам видимости отделов)",[308,309,312],"callout",{"color":310,"icon":311},"neutral","i-lucide-gauge",[95,313,314,315,318,319,322,323,327],{},"Эндпоинты ",[99,316,317],{},"GET \u002Fv1\u002Fusers"," и ",[99,320,321],{},"GET \u002Fv1\u002Fusers\u002F{uuid}"," защищены лимитом ",[324,325,326],"strong",{},"60 запросов в минуту"," на субъект (или на IP-адрес для анонимных вызовов).",[112,329,331],{"id":330},"редактирование-профиля","Редактирование профиля",[333,334,339],"pre",{"className":335,"code":336,"language":337,"meta":338,"style":338},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","PATCH \u002Fv1\u002Fusers\u002F{uuid}\nAuthorization: Bearer \u003Caccess_token>\nContent-Type: application\u002Fjson\n\n{\n  \"username\": \"new_nick\",\n  \"firstname\": \"Иван\",\n  \"lastname\": \"Иванов\"\n}\n","http","",[99,340,341,349,355,361,368,374,380,386,392],{"__ignoreMap":338},[342,343,346],"span",{"class":344,"line":345},"line",1,[342,347,348],{},"PATCH \u002Fv1\u002Fusers\u002F{uuid}\n",[342,350,352],{"class":344,"line":351},2,[342,353,354],{},"Authorization: Bearer \u003Caccess_token>\n",[342,356,358],{"class":344,"line":357},3,[342,359,360],{},"Content-Type: application\u002Fjson\n",[342,362,364],{"class":344,"line":363},4,[342,365,367],{"emptyLinePlaceholder":366},true,"\n",[342,369,371],{"class":344,"line":370},5,[342,372,373],{},"{\n",[342,375,377],{"class":344,"line":376},6,[342,378,379],{},"  \"username\": \"new_nick\",\n",[342,381,383],{"class":344,"line":382},7,[342,384,385],{},"  \"firstname\": \"Иван\",\n",[342,387,389],{"class":344,"line":388},8,[342,390,391],{},"  \"lastname\": \"Иванов\"\n",[342,393,395],{"class":344,"line":394},9,[342,396,397],{},"}\n",[399,400,401,405,436,447],"ul",{},[402,403,404],"li",{},"Необходимо передать хотя бы одно поле; отсутствующие поля не изменяются.",[402,406,407,408],{},"Допустимые поля и ограничения:\n",[399,409,410,419,424,431],{},[402,411,412,414,415,418],{},[99,413,244],{}," — от 3 до 32 символов, паттерн ",[99,416,417],{},"^[a-zA-Z0-9_-]{3,32}$",";",[402,420,421,423],{},[99,422,265],{}," — валидный email до 320 символов;",[402,425,426,241,428,430],{},[99,427,268],{},[99,429,271],{}," — от 1 до 128 символов;",[402,432,433,435],{},[99,434,274],{}," — до 128 символов.",[402,437,438,439,442,443,446],{},"Пользователь может изменять собственный профиль (",[99,440,441],{},"users.profile:write:self","), администратор — любой (",[99,444,445],{},"users.profile:write",").",[402,448,449,450,453],{},"При конкурентном обновлении одного профиля может вернуться ",[99,451,452],{},"409 Conflict"," — запрос безопасно повторить.",[112,455,457],{"id":456},"просмотр-прав-пользователя","Просмотр прав пользователя",[333,459,461],{"className":335,"code":460,"language":337,"meta":338,"style":338},"GET \u002Fv1\u002Fusers\u002F{uuid}\u002Fpermissions\n",[99,462,463],{"__ignoreMap":338},[342,464,465],{"class":344,"line":345},[342,466,460],{},[95,468,469,470,473,474,477,478,110],{},"Возвращает итоговый плоский список строк прав (",[99,471,472],{},"string[]","). Доступно владельцу (",[99,475,476],{},"users.permissions:read:self",") либо вызывающему с глобальным\u002Fделегированным правом ",[99,479,480],{},"authservice.users.permissions:read",[112,482,484],{"id":483},"загрузка-аватара-и-баннера","Загрузка аватара и баннера",[333,486,488],{"className":335,"code":487,"language":337,"meta":338,"style":338},"PATCH \u002Fv1\u002Fusers\u002F{uuid}\u002Favatar\nPATCH \u002Fv1\u002Fusers\u002F{uuid}\u002Fbanner\nContent-Type: multipart\u002Fform-data\n",[99,489,490,495,500],{"__ignoreMap":338},[342,491,492],{"class":344,"line":345},[342,493,494],{},"PATCH \u002Fv1\u002Fusers\u002F{uuid}\u002Favatar\n",[342,496,497],{"class":344,"line":351},[342,498,499],{},"PATCH \u002Fv1\u002Fusers\u002F{uuid}\u002Fbanner\n",[342,501,502],{"class":344,"line":357},[342,503,504],{},"Content-Type: multipart\u002Fform-data\n",[95,506,507,508,511],{},"Изображения валидируются и автоматически конвертируются в ",[324,509,510],{},"WebP",":",[117,513,514,531],{},[120,515,516],{},[123,517,518,521,526],{},[126,519,520],{},"Параметр",[126,522,523,524,164],{},"Аватар (",[99,525,247],{},[126,527,528,529,164],{},"Баннер (",[99,530,250],{},[139,532,533,557,568,582,605,622],{},[123,534,535,538,549],{},[144,536,537],{},"Допустимые типы",[144,539,540,241,543,241,546],{},[99,541,542],{},"image\u002Fjpeg",[99,544,545],{},"image\u002Fpng",[99,547,548],{},"image\u002Fwebp",[144,550,551,241,553,241,555],{},[99,552,542],{},[99,554,545],{},[99,556,548],{},[123,558,559,562,565],{},[144,560,561],{},"Максимальный размер файла",[144,563,564],{},"5 МБ",[144,566,567],{},"10 МБ",[123,569,570,573,576],{},[144,571,572],{},"Пропорции",[144,574,575],{},"Квадрат (допуск ±2 px)",[144,577,578,579,164],{},"Альбомная ориентация (",[99,580,581],{},"width >= height",[123,583,584,587,597],{},[144,585,586],{},"Разрешение входа",[144,588,589,590,593,594],{},"от ",[99,591,592],{},"128×128"," до ",[99,595,596],{},"4096×4096",[144,598,589,599,593,602],{},[99,600,601],{},"1536×512",[99,603,604],{},"10000×5000",[123,606,607,610,617],{},[144,608,609],{},"Итоговый формат",[144,611,612,613,616],{},"WebP, до ",[99,614,615],{},"1024×1024"," (кроп, без апскейла)",[144,618,612,619,616],{},[99,620,621],{},"3000×1000",[123,623,624,627,630],{},[144,625,626],{},"Rate limit",[144,628,629],{},"3 загрузки за 5 минут",[144,631,629],{},[95,633,634,635,638,639,110],{},"При несоответствии требованиям возвращается ",[99,636,637],{},"400 Bad Request"," с ",[99,640,641],{},"error: \"invalid_image\"",[112,643,645],{"id":644},"управление-сессиями","Управление сессиями",[117,647,648,662],{},[120,649,650],{},[123,651,652,654,656,659],{},[126,653,128],{},[126,655,131],{},[126,657,658],{},"Параметры",[126,660,661],{},"Описание",[139,663,664,704],{},[123,665,666,670,675,684],{},[144,667,668],{},[99,669,148],{},[144,671,672],{},[99,673,674],{},"\u002Fv1\u002Fusers\u002F{uuid}\u002Fsessions",[144,676,677,680,681,164],{},[99,678,679],{},"?onlyActive=true"," (по умолчанию ",[99,682,683],{},"true",[144,685,686,687,241,689,241,692,241,695,241,698,241,701,164],{},"Список сессий пользователя (",[99,688,240],{},[99,690,691],{},"created_at",[99,693,694],{},"updated_at",[99,696,697],{},"expires_at",[99,699,700],{},"ip_addresses",[99,702,703],{},"user_agent",[123,705,706,711,716,718],{},[144,707,708],{},[99,709,710],{},"DELETE",[144,712,713],{},[99,714,715],{},"\u002Fv1\u002Fusers\u002F{uuid}\u002Fsessions\u002F{sessionId}",[144,717,277],{},[144,719,720,721,164],{},"Принудительный отзыв конкретной сессии (",[99,722,723],{},"204 No Content",[95,725,726,727,730,731,734,735,738,739,446],{},"Владелец работает со своими сессиями по базовым правам ",[99,728,729],{},":self","; доступ к чужим сессиям требует ",[99,732,733],{},"authservice.users.sessions:read"," \u002F ",[99,736,737],{},"authservice.users.sessions:delete"," (глобально или со скоупом ",[99,740,741],{},"{uuid}",[112,743,745],{"id":744},"участие-в-отделах","Участие в отделах",[333,747,749],{"className":335,"code":748,"language":337,"meta":338,"style":338},"GET \u002Fv1\u002Fusers\u002F{userId}\u002Fdepartments\n",[99,750,751],{"__ignoreMap":338},[342,752,753],{"class":344,"line":345},[342,754,748],{},[95,756,757,758,761,762,110],{},"Возвращает список отделов пользователя и его ролей в них. Для собственного ",[99,759,760],{},"userId"," возвращаются все участия; для чужого — только те, которые вызывающий имеет право видеть по правилам видимости ",[763,764,765],"a",{"href":60},"отделов",[767,768,769],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":338,"searchDepth":351,"depth":351,"links":771},[772,775,776,777,778,779],{"id":114,"depth":351,"text":115,"children":773},[774],{"id":208,"depth":357,"text":209},{"id":330,"depth":351,"text":331},{"id":456,"depth":351,"text":457},{"id":483,"depth":351,"text":484},{"id":644,"depth":351,"text":645},{"id":744,"depth":351,"text":745},"Получение и редактирование профиля пользователя, требования к загрузке аватаров и баннеров, управление активными сессиями.","md",null,{},{"title":54,"icon":57},{"title":90,"description":780},"gS8Qx74FKI3evNaxF6Un4n4NvH-VovvWbfujRtf5yH8",[788,790],{"title":49,"path":50,"stem":51,"description":789,"icon":52,"children":-1},"Иерархическая модель прав base:operation:scope, скоупы self и делегирование по UUID, справочник прав Julia.",{"title":59,"path":60,"stem":61,"description":791,"icon":62,"children":-1},"Иерархия отделов, slug, системные и кастомные роли, старшинство, правила видимости и справочник кодов ошибок.",1795320979184]