Studio Assets API
Подключите библиотеку к вашим инструментам.
Находите ассеты, управляйте версиями и готовьте файлы для Unity.
https://nordmans.devREST · JSONПолучите токен
Войдите в библиотеку и откройте меню аккаунта → API-токены. Создайте отдельный токен для своего приложения.
Выберите метод
Найдите операцию ниже. У каждой есть параметры, права доступа, схема запроса и варианты ответа.
Сделайте запрос
Передайте токен в заголовке Authorization. Для импорта в ваши инструменты скачайте OpenAPI JSON.
Авторизация
Для приложений — Bearer
Authorization: Bearer <token>
Токен действует 90 дней и использует текущие права владельца. Секрет показывается при создании один раз. Отозвать его можно в библиотеке или через API.
Для браузера — cookie + CSRF
POST /api/auth/login создаёт сессию на 8 часов. Изменяющие запросы с cookie требуют X-CSRF-Token из ответа входа или GET /api/auth/me. Bearer-запросам CSRF не нужен.
Читатель просматривает и скачивает. Редактор изменяет общие ассеты, а проектные — при наличии права записи в проекте. Администратор имеет полный доступ. CORS для операций API не включён: внешние приложения обращаются к API с сервера; браузерные запросы выполняются с того же origin.
Файлы, версии и ошибки
Неизменяемые версии
Файлы загружаются как Base64 в JSON. Лимит сообщает GET /api/health. Новая загрузка по умолчанию остаётся в истории. Указатели source и unity назначаются отдельно.
Для переключения текущей версии передайте expected_current_id. При 409 перечитайте карточку: другой пользователь мог уже изменить указатель.
Единый ответ об ошибке
{"error": "описание"}
Для ошибочного Range при запросе медиа возвращается 416 с пустым телом.
400 — параметры; 401 — авторизация; 403 — права или CSRF; 404 — ресурс; 409 — конфликт; 413 — размер; 415 — формат; 429 — лимит.
JSON-запросы требуют Content-Type: application/json и Content-Length, который обычно выставляет HTTP-клиент.
Как упаковать ассет
Для готового ассета выберите рубрику, точку входа и действие. Для работы с исходниками сохраните состав версии, GUID и оригинальные метафайлы. Руководство разбирает эти решения на примере дома с эффектом огня и показывает, как описать уже загруженный пакет.
Руководство для издателей и агентов (Markdown) · Таксономия и действия
OpenAPI и MCP
HTTP-клиенты и агенты могут получить полный контракт по /openapi.json. Его можно читать без токена, в том числе из внешнего браузерного инструмента. Отдельный MCP-клиент из проекта подключается через stdio и объявляет свои инструменты через tools/list. Ресурс sam://guides/publication выдаёт руководство той же версии сервера. Категории и действия доступны через get_catalog_taxonomy, готовые ассеты — через search_ready_assets.
По умолчанию MCP предоставляет поиск, карточки, версии, сведения для скачивания, форматы и чтение заданий. Создание карточек, изменение метаданных, текущей версии и подготовка для Unity включаются настройкой STUDIO_ASSETS_MCP_ALLOW_WRITES=1; права пользователя продолжают действовать.
Весь API
Все действующие операции сервиса.
Загружаем спецификацию…