[{"data":1,"prerenderedAt":666},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Foverview":88,"\u002Fgetting-started\u002Foverview-surround":663},[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":11,"body":90,"description":656,"extension":657,"hideToc":20,"links":658,"meta":659,"navigation":660,"path":12,"seo":661,"stem":13,"wide":20,"__hash__":662},"docs\u002F1.getting-started\u002F1.overview.md",{"type":91,"value":92,"toc":649},"minimark",[93,114,117,169,174,251,263,267,274,346,360,502,506,509,566,575,579,582,613,626,630,645],[94,95,96,100,101,105,106,113],"p",{},[97,98,99],"strong",{},"Julia"," (",[102,103,104],"code",{},"Cyberzone.Julia",") — централизованный сервис аутентификации, авторизации, управления профилями пользователей и структурой отделов в экосистеме ",[107,108,112],"a",{"href":109,"rel":110},"https:\u002F\u002Fcyberzone.dev\u002F",[111],"nofollow","Cyberzone Dev",".",[94,115,116],{},"Сервис предоставляет:",[118,119,120,131,136],"ul",{},[121,122,123,130],"li",{},[97,124,125,126,129],{},"REST API (",[102,127,128],{},"\u002Fv1",")"," — аутентификация пользователей (OAuth redirect flow, обновление токенов, выход), OIDC\u002FJWKS discovery, управление профилями, медиа, сессиями и отделами.",[121,132,133,135],{},[97,134,79],{}," — сервисные вызовы для чтения пользователей и отделов, получения публичного ключа подписи и интроспекции\u002Fуправления API-ключами.",[121,137,138,141,142,151,152,155,156,161,162,165,166,113],{},[97,139,140],{},"Официальные SDK"," — публичные NuGet-пакеты ",[107,143,144,147,148],{"href":71},[102,145,146],{},"Cyberzone.Julia.Contracts"," и ",[102,149,150],{},"Cyberzone.Julia.Authorization"," для ",[97,153,154],{},".NET"," и Go-модуль ",[107,157,158],{"href":76},[102,159,160],{},"git.cyberzone.dev\u002Fcyberzone\u002Fjulia-go"," (пре-релиз ",[102,163,164],{},"v0.1.0-rc.1",") для ",[97,167,168],{},"Go",[170,171,173],"h2",{"id":172},"базовые-адреса-и-конвенции","Базовые адреса и конвенции",[175,176,177,190],"table",{},[178,179,180],"thead",{},[181,182,183,187],"tr",{},[184,185,186],"th",{},"Параметр",[184,188,189],{},"Значение",[191,192,193,204,214,225,238],"tbody",{},[181,194,195,199],{},[196,197,198],"td",{},"Production Base URL",[196,200,201],{},[102,202,203],{},"https:\u002F\u002Fauth.mirea.app\u002F",[181,205,206,209],{},[196,207,208],{},"Версия REST API",[196,210,211,213],{},[102,212,128],{}," (версионирование в сегменте URL)",[181,215,216,219],{},[196,217,218],{},"Формат JSON",[196,220,221,224],{},[102,222,223],{},"snake_case"," для всех REST-запросов и ответов",[181,226,227,230],{},[196,228,229],{},"Схемы аутентификации",[196,231,232,147,235],{},[102,233,234],{},"Authorization: Bearer \u003Cjwt>",[102,236,237],{},"X-Api-Key: \u003Ckey>",[181,239,240,243],{},[196,241,242],{},"Discovery",[196,244,245,147,248],{},[102,246,247],{},"\u002F.well-known\u002Fopenid-configuration",[102,249,250],{},"\u002F.well-known\u002Fjwks.json",[252,253,256],"callout",{"color":254,"icon":255},"primary","i-lucide-info",[94,257,258,259,262],{},"Discovery-эндпоинты под ",[102,260,261],{},"\u002F.well-known\u002F*"," публичны и поддерживают CORS для любых источников — их можно безопасно запрашивать напрямую со сторонних сервисов и клиентов.",[170,264,266],{"id":265},"формат-ошибок","Формат ошибок",[94,268,269,270,273],{},"Ошибки бизнес-логики, доступа и ограничений возвращаются в едином JSON-формате и сопровождаются заголовком ",[102,271,272],{},"X-Request-Id"," для диагностики:",[275,276,281],"pre",{"className":277,"code":278,"language":279,"meta":280,"style":280},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"error\": \"forbidden\",\n  \"message\": \"Access denied\"\n}\n","json","",[102,282,283,292,320,340],{"__ignoreMap":280},[284,285,288],"span",{"class":286,"line":287},"line",1,[284,289,291],{"class":290},"sMK4o","{\n",[284,293,295,298,302,305,308,311,315,317],{"class":286,"line":294},2,[284,296,297],{"class":290},"  \"",[284,299,301],{"class":300},"spNyl","error",[284,303,304],{"class":290},"\"",[284,306,307],{"class":290},":",[284,309,310],{"class":290}," \"",[284,312,314],{"class":313},"sfazB","forbidden",[284,316,304],{"class":290},[284,318,319],{"class":290},",\n",[284,321,323,325,328,330,332,334,337],{"class":286,"line":322},3,[284,324,297],{"class":290},[284,326,327],{"class":300},"message",[284,329,304],{"class":290},[284,331,307],{"class":290},[284,333,310],{"class":290},[284,335,336],{"class":313},"Access denied",[284,338,339],{"class":290},"\"\n",[284,341,343],{"class":286,"line":342},4,[284,344,345],{"class":290},"}\n",[94,347,348,349,352,353,356,357,113],{},"При ошибках валидации входных параметров (обязательные поля, форматы, длины строк) возвращается ",[102,350,351],{},"400 Bad Request"," в формате RFC 9457 (",[102,354,355],{},"ProblemDetails",") либо стандартный ",[102,358,359],{},"ErrorResponse",[175,361,362,377],{},[178,363,364],{},[181,365,366,369,374],{},[184,367,368],{},"HTTP-статус",[184,370,371,372],{},"Типовое значение ",[102,373,301],{},[184,375,376],{},"Когда возникает",[191,378,379,399,414,435,450,468,483],{},[181,380,381,386,392],{},[196,382,383],{},[102,384,385],{},"400",[196,387,388,391],{},[102,389,390],{},"bad_request"," или код предметной области",[196,393,394,395,398],{},"Некорректные параметры запроса, невалидное изображение (",[102,396,397],{},"invalid_image","), нарушения правил отдела",[181,400,401,406,411],{},[196,402,403],{},[102,404,405],{},"401",[196,407,408],{},[102,409,410],{},"unauthorized",[196,412,413],{},"Отсутствует, истёк или невалиден JWT \u002F API-ключ",[181,415,416,421,432],{},[196,417,418],{},[102,419,420],{},"403",[196,422,423,425,426,425,429],{},[102,424,314],{},", ",[102,427,428],{},"insufficient_rank",[102,430,431],{},"permission_not_held",[196,433,434],{},"Недостаточно прав или старшинства для выполнения операции",[181,436,437,442,447],{},[196,438,439],{},[102,440,441],{},"404",[196,443,444],{},[102,445,446],{},"not_found",[196,448,449],{},"Ресурс не существует или скрыт от текущего вызывающего",[181,451,452,457,465],{},[196,453,454],{},[102,455,456],{},"409",[196,458,459,425,462],{},[102,460,461],{},"conflict",[102,463,464],{},"already_member",[196,466,467],{},"Конфликт состояния (например, повторное добавление участника или конкурентное изменение профиля)",[181,469,470,475,480],{},[196,471,472],{},[102,473,474],{},"422",[196,476,477],{},[102,478,479],{},"membership_grants_disabled",[196,481,482],{},"Операция отклонена политикой сервиса",[181,484,485,490,495],{},[196,486,487],{},[102,488,489],{},"429",[196,491,492],{},[102,493,494],{},"too_many_requests",[196,496,497,498,501],{},"Превышен лимит запросов (дополнительно возвращается заголовок ",[102,499,500],{},"Retry-After"," в секундах)",[170,503,505],{"id":504},"ограничения-частоты-запросов-rate-limits","Ограничения частоты запросов (Rate Limits)",[94,507,508],{},"На публичных и ресурсоёмких REST-эндпоинтах действуют лимиты с фиксированным окном:",[175,510,511,527],{},[178,512,513],{},[181,514,515,518,521,524],{},[184,516,517],{},"Политика",[184,519,520],{},"Эндпоинты",[184,522,523],{},"Лимит",[184,525,526],{},"Партиционирование",[191,528,529,550],{},[181,530,531,536,544,547],{},[196,532,533],{},[102,534,535],{},"PublicProfileRead",[196,537,538,425,541],{},[102,539,540],{},"GET \u002Fv1\u002Fusers",[102,542,543],{},"GET \u002Fv1\u002Fusers\u002F{uuid}",[196,545,546],{},"60 запросов \u002F 1 минута",[196,548,549],{},"По субъекту (для авторизованных) или по IP клиента (для анонимных)",[181,551,552,557,560,563],{},[196,553,554],{},[102,555,556],{},"ImageUploadPerUser",[196,558,559],{},"Загрузка аватаров и баннеров пользователей и отделов",[196,561,562],{},"3 запроса \u002F 5 минут",[196,564,565],{},"По субъекту",[94,567,568,569,572,573,113],{},"При превышении лимита возвращается ",[102,570,571],{},"429 Too Many Requests"," с заголовком ",[102,574,500],{},[170,576,578],{"id":577},"подключение-нового-приложения","Подключение нового приложения",[94,580,581],{},"Для интеграции вашего приложения или бэкенд-сервиса потребуется:",[583,584,585,603],"ol",{},[121,586,587,590,591,594,595,598,599,602],{},[97,588,589],{},"Для веб-приложения с входом пользователей"," — регистрация ",[102,592,593],{},"ClientApplication"," (вы получаете ",[102,596,597],{},"sourceId"," и фиксируете разрешённый ",[102,600,601],{},"callback_url",").",[121,604,605,608,609,612],{},[97,606,607],{},"Для бэкенд-сервиса"," — выпуск сервисного API-ключа (",[102,610,611],{},"cza-svc-...",") с минимально необходимым набором прав и, при возможности, списком разрешённых IP-адресов.",[94,614,615,616,621,622,113],{},"Запросить регистрацию клиента или выпуск ключа можно через Telegram ",[107,617,620],{"href":618,"rel":619},"https:\u002F\u002Ft.me\u002Fsaph1s",[111],"@saph1s"," или по почте ",[107,623,625],{"href":624},"mailto:saph1s@cyberzone.dev?subject=Julia","saph1s@cyberzone.dev",[170,627,629],{"id":628},"дальнейшие-шаги","Дальнейшие шаги",[631,632,633,639],"card-group",{},[634,635,636],"card",{"icon":19,"title":16,"to":17},[94,637,638],{},"Пошаговое подключение входа пользователей и проверка JWT в вашем сервисе.",[634,640,642],{"icon":87,"title":641,"to":85},"OpenAPI Reference",[94,643,644],{},"Изучите все доступные REST-эндпоинты в интерактивном Scalar UI.",[646,647,648],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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":280,"searchDepth":294,"depth":294,"links":650},[651,652,653,654,655],{"id":172,"depth":294,"text":173},{"id":265,"depth":294,"text":266},{"id":504,"depth":294,"text":505},{"id":577,"depth":294,"text":578},{"id":628,"depth":294,"text":629},"Назначение Julia (Cyberzone.Julia), базовые адреса, конвенции API, формат ошибок и лимиты запросов.","md",null,{},{"icon":14},{"title":11,"description":656},"ejEbmZ4V2WdHIPSdAsbfGh0qseeOv3UqPI3f4M7Vr0w",[658,664],{"title":16,"path":17,"stem":18,"description":665,"icon":19,"children":-1},"Пошаговая интеграция веб-приложения и бэкенд-сервиса с Julia за несколько минут.",1795320979027]