[{"data":1,"prerenderedAt":338},["ShallowReactive",2],{"navigation_docs_ru":3,"-ru-api-rest-api":110,"-ru-api-rest-api-surround":333},[4,20,55,70,90,100],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Начало работы",false,"\u002Fru\u002Fgetting-started","ru\u002F1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Введение","\u002Fru\u002Fgetting-started\u002Fintroduction","ru\u002F1.getting-started\u002F1.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Быстрый старт","\u002Fru\u002Fgetting-started\u002Fquickstart","ru\u002F1.getting-started\u002F2.quickstart","i-lucide-rocket",{"title":21,"icon":6,"path":22,"stem":23,"children":24,"page":6},"Концепции","\u002Fru\u002Fconcepts","ru\u002F2.concepts",[25,30,35,40,45,50],{"title":26,"path":27,"stem":28,"icon":29},"Проекты и версии","\u002Fru\u002Fconcepts\u002Fprojects-and-versions","ru\u002F2.concepts\u002F1.projects-and-versions","i-lucide-boxes",{"title":31,"path":32,"stem":33,"icon":34},"Файлы конфигурации","\u002Fru\u002Fconcepts\u002Ffiles","ru\u002F2.concepts\u002F2.files","i-lucide-file-json",{"title":36,"path":37,"stem":38,"icon":39},"Публикация","\u002Fru\u002Fconcepts\u002Fpublishing","ru\u002F2.concepts\u002F3.publishing","i-lucide-send",{"title":41,"path":42,"stem":43,"icon":44},"Доступ и роли","\u002Fru\u002Fconcepts\u002Faccess","ru\u002F2.concepts\u002F4.access","i-lucide-users",{"title":46,"path":47,"stem":48,"icon":49},"Шифрование","\u002Fru\u002Fconcepts\u002Fencryption","ru\u002F2.concepts\u002F5.encryption","i-lucide-lock",{"title":51,"path":52,"stem":53,"icon":54},"Git-интеграция","\u002Fru\u002Fconcepts\u002Fgit","ru\u002F2.concepts\u002F6.git","i-lucide-git-branch",{"title":56,"icon":6,"path":57,"stem":58,"children":59,"page":6},"SDK","\u002Fru\u002Fsdk","ru\u002F3.sdk",[60,65],{"title":61,"path":62,"stem":63,"icon":64},"Node.js","\u002Fru\u002Fsdk\u002Fnodejs","ru\u002F3.sdk\u002F1.nodejs","i-simple-icons-nodedotjs",{"title":66,"path":67,"stem":68,"icon":69},"Unity","\u002Fru\u002Fsdk\u002Funity","ru\u002F3.sdk\u002F2.unity","i-simple-icons-unity",{"title":71,"icon":6,"path":72,"stem":73,"children":74,"page":6},"API и MCP","\u002Fru\u002Fapi","ru\u002F4.api",[75,80,85],{"title":76,"path":77,"stem":78,"icon":79},"API-токены","\u002Fru\u002Fapi\u002Fauthentication","ru\u002F4.api\u002F1.authentication","i-lucide-key-round",{"title":81,"path":82,"stem":83,"icon":84},"REST API","\u002Fru\u002Fapi\u002Frest-api","ru\u002F4.api\u002F2.rest-api","i-lucide-plug",{"title":86,"path":87,"stem":88,"icon":89},"MCP для ИИ-агентов","\u002Fru\u002Fapi\u002Fmcp","ru\u002F4.api\u002F3.mcp","i-lucide-bot",{"title":91,"icon":6,"path":92,"stem":93,"children":94,"page":6},"Поддержка","\u002Fru\u002Fsupport","ru\u002F5.support",[95],{"title":96,"path":97,"stem":98,"icon":99},"Обратная связь","\u002Fru\u002Fsupport\u002Ffeedback","ru\u002F5.support\u002F1.feedback","i-lucide-message-circle",{"title":101,"icon":6,"path":102,"stem":103,"children":104,"page":6},"Правовая информация","\u002Fru\u002Flegal","ru\u002F6.legal",[105],{"title":106,"path":107,"stem":108,"icon":109},"Политика конфиденциальности","\u002Fru\u002Flegal\u002Fprivacy","ru\u002F6.legal\u002F1.privacy","i-lucide-shield",{"id":111,"title":81,"body":112,"description":324,"extension":325,"links":326,"meta":327,"navigation":328,"path":82,"seo":329,"stem":83,"__hash__":332},"docs_ru\u002Fru\u002F4.api\u002F2.rest-api.md",{"type":113,"value":114,"toc":313},"minimark",[115,129,136,140,145,215,219,257,263,274,277,281,292,296,306,310],[116,117,118,119,123,124,128],"p",{},"Базовый URL: ",[120,121,122],"code",{},"https:\u002F\u002F\u003Cyour-veresk-host>\u002Fapi\u002Fv1",". Аутентификация — ",[125,126,127],"a",{"href":77},"API-токеном",".",[116,130,131,132,135],{},"Полный актуальный справочник со схемами запросов и ответов отдаёт ваш экземпляр Veresk по адресу ",[120,133,134],{},"\u002Fapi\u002Fv1\u002Fdocs"," (Swagger). Эта страница объясняет, как части складываются вместе.",[137,138,139],"note",{},"Проекты создаются и настраиваются в интерфейсе Veresk. API работает с существующими проектами.",[141,142,144],"h2",{"id":143},"эндпоинты","Эндпоинты",[146,147,148,161],"table",{},[149,150,151],"thead",{},[152,153,154,158],"tr",{},[155,156,157],"th",{},"Область",[155,159,160],{},"Что можно делать",[162,163,164,175,183,191,207],"tbody",{},[152,165,166,170],{},[167,168,169],"td",{},"Аккаунт",[167,171,172],{},[120,173,174],{},"GET \u002Fme",[152,176,177,180],{},[167,178,179],{},"Проекты",[167,181,182],{},"Список доступных проектов; получить один",[152,184,185,188],{},[167,186,187],{},"Версии",[167,189,190],{},"Список, создание от родителя, изменение описания, публикация, сравнение двух версий, копирование файлов между версиями",[152,192,193,196],{},[167,194,195],{},"Файлы",[167,197,198,199,202,203,206],{},"Список (с фильтрами ",[120,200,201],{},"search"," и ",[120,204,205],{},"tag","), создание, метаданные, переименование и описание, чтение и запись содержимого по версиям, сброс к унаследованному содержимому",[152,208,209,212],{},[167,210,211],{},"Потребители и теги",[167,213,214],{},"Список потребителей; список и создание тегов; назначение файла потребителям и тегам",[141,216,218],{"id":217},"типичный-сценарий-поменять-значение-и-опубликовать","Типичный сценарий: поменять значение и опубликовать",[220,221,222,229,235,244,252],"ol",{},[223,224,225,228],"li",{},[120,226,227],{},"GET \u002Fprojects"," — найти id проекта.",[223,230,231,234],{},[120,232,233],{},"GET \u002Fprojects\u002F{projectId}\u002Ffiles?search=settings"," — найти id файла.",[223,236,237,240,241,128],{},[120,238,239],{},"GET \u002Fprojects\u002F{projectId}\u002Ffiles\u002F{fileId}\u002Fversions\u002F{versionId}"," — прочитать содержимое. Сохраните полученный ",[120,242,243],{},"etag",[223,245,246,249,250,128],{},[120,247,248],{},"PUT"," на тот же URL с полным новым содержимым и ",[120,251,243],{},[223,253,254,128],{},[120,255,256],{},"POST \u002Fprojects\u002F{projectId}\u002Fversions\u002F{versionId}\u002Fpublish",[141,258,260,261],{"id":259},"безопасное-обновление-через-etag","Безопасное обновление через ",[120,262,243],{},[116,264,265,266,270,271,273],{},"Запись файла заменяет его ",[267,268,269],"strong",{},"всё"," содержимое в этой версии, и у версии появляется собственная копия файла. Передайте ",[120,272,243],{},", полученный при чтении. Если за это время кто-то изменил файл, запрос завершится ошибкой конфликта, а не перезапишет чужое изменение.",[116,275,276],{},"JSON-файлы принимают JSON-значение, остальные — строку. Заблокированная версия отклоняет запись.",[141,278,280],{"id":279},"наследование-в-api","Наследование в API",[116,282,283,284,287,288,291],{},"Чтение содержимого файла возвращает содержимое ",[267,285,286],{},"в том виде, как оно отдаётся"," в этой версии: собственная копия или унаследованная. Ответ сообщает, из какой версии оно реально взято (",[120,289,290],{},"resolvedVersion",").",[141,293,295],{"id":294},"след-автоматизации","След автоматизации",[116,297,298,299,202,302,305],{},"Файлы, созданные или изменённые через API, получают теги ",[120,300,301],{},"api-created",[120,303,304],{},"api-edited",", поэтому видно, что трогала автоматизация.",[141,307,309],{"id":308},"недоступно-через-api","Недоступно через API",[116,311,312],{},"В целях безопасности публичный API не может удалять и создавать проекты, менять роли, перевыпускать ключ шифрования, менять Git, флаги шифрования и настройки валидации. Для этого используйте интерфейс.",{"title":314,"searchDepth":315,"depth":315,"links":316},"",2,[317,318,319,321,322,323],{"id":143,"depth":315,"text":144},{"id":217,"depth":315,"text":218},{"id":259,"depth":315,"text":320},"Безопасное обновление через etag",{"id":279,"depth":315,"text":280},{"id":294,"depth":315,"text":295},{"id":308,"depth":315,"text":309},"Управляйте версиями, файлами и публикацией по HTTP.","md",null,{},{"icon":84},{"title":330,"description":331},"REST API Veresk","Публичный REST API Veresk по адресу \u002Fapi\u002Fv1. Аутентификация, обзор эндпоинтов, безопасное обновление файлов через etag и публикация на CDN.","J5NVjUocA1nvG9-ZaBU6qTX5ZVTiRE84LgxxoLG0KCc",[334,336],{"title":76,"path":77,"stem":78,"description":335,"icon":79,"children":-1},"Создайте персональный API-токен и аутентифицируйте запросы к REST и MCP.",{"title":86,"path":87,"stem":88,"description":337,"icon":89,"children":-1},"Подключите ИИ-агента к Veresk по Model Context Protocol.",1793977344166]