Хранилище исходного кода

Хранилище исходного кода автоматически сохраняет снимки кода вашего приложения при каждом деплое. Если над приложением начинает работать другой человек или новая AI-сессия, последнюю версию можно скачать и продолжить с того же места — код не потеряется.

Разделы документации

• Автоматическое сохранение при деплое — что попадает в снапшот само, блок source в ответе деплоя, деплой из сохранённой версии
• Снапшот перед публикацией — что проверяется перед публикацией, отказ 409 SNAPSHOT_REQUIRED, публикация исходников с сервера
• Сохранить снапшот — POST /v1/apps/:id/sources, заголовки метаданных, дедупликация
• Список версий — история версий приложения и связанные серверные версии
• Получить метаданные версии — одна версия по идентификатору
• Скачать архив — подписанная ссылка на архив версии
• Теги и комментарии версии — PATCH метаданных и постановка тега
• Удалить версию — удаление по идентификатору
• Очистить старые версии — массовая очистка истории
• Срок жизни версий и очистка — политика хранения, версии удалённого сервера, объекты в хранилище
• Серверные эндпоинты исходников — то же семейство с ключом сервера
• Реестр исходников и состояние портала — GET /v1/me/sources, страница кабинета, capabilities.apps.sourceStorage

Зачем это нужно

Когда вы дорабатываете приложение, важно не потерять рабочую версию кода. Хранилище делает это автоматически: при каждом успешном деплое платформа сохраняет снимок исходников. Если позже над приложением начнёт работать другой человек или новая AI-сессия — он скачает последнюю версию и продолжит с того же места, без ручной пересылки архивов.

Снимок привязан к приложению, а не к конкретному разработчику: код остаётся у приложения, даже если меняется команда.

Чем это отличается от Git и GitHub

Это не система контроля версий и не замена Git. Хранилище решает более узкую задачу — страховка и передача проекта.

Нужна командная разработка с ветками и историей — используйте Git. Нужно просто не терять рабочий код и уметь вернуться к прошлой версии — достаточно хранилища.

Как это работает

1. Вы дорабатываете приложение и запускаете деплой.
2. Платформа сама сохраняет снимок исходников — очередную версию: v1, v2, v3, …
3. В любой момент смотрите список версий и скачиваете нужную.
4. Перед публикацией приложения платформа проверяет, что снимок сохранён.

правка кода  →  деплой  →  снимок vN сохранён автоматически
                                      ↓
        список версий  →  скачать любую  →  продолжить работу

Основные понятия

• Снимок (снапшот) — заархивированная копия исходного кода приложения на момент сохранения.
• Версия vN — порядковый номер снимка (v1, v2, …). Самый свежий считается текущим.
• Тег — метка manual или published: помечает версию как важную, чтобы её не удалила автоматическая очистка.
• Дедупликация — если код не изменился, новый снимок не создаётся, возвращается уже существующая версия. Действует в пределах одного владельца — сервера или приложения.

Доступ

Базовый URL: https://vibecode.bitrix24.tech/v1
Авторизация: заголовок X-Api-Key. Управлять снапшотами могут ключ авторизации приложения (vibe_app_*), личный ключ автора приложения (vibe_api_*) или администратор портала.
Допустимые форматы архива: application/gzip, application/x-tar, application/zip, application/octet-stream.
Лимит тела: 500 МБ на один запрос.

Контракт сохранения

Тело POST …/sources — сырые байты архива, не multipart/form-data. Метаданные передаются заголовками, а не полями формы и не query-параметрами.

curl -X POST https://vibecode.bitrix24.tech/v1/apps/<APP_ID>/sources \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Content-Type: application/gzip" \
  -H "X-Tags: manual" \
  -H "X-Note: Добавил OAuth-флоу" \
  --data-binary @app-sources.tar.gz

Источник кода при развёртывании — поле source в POST /v1/infra/servers/:id/deploy принимает три взаимоисключающие формы:

Полный разбор сохранения — Сохранить снапшот, автосохранение и деплой из версии — Автоматическое сохранение при деплое.

Быстрый старт

Передать проект другому разработчику или новой AI-сессии — три вызова:

# 1. Что вообще сохранено под этим приложением
curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/apps/<APP_ID>/sources

# 2. Ссылка на архив нужной версии (действует 30 минут)
curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/apps/<APP_ID>/sources/v1/download

# 3. Скачать архив по полученной ссылке — без дополнительных заголовков
curl -o source-v1.tar.gz "<url из ответа выше>"

Полный пример

Непрерывный сценарий: сохранить снапшот, посмотреть список версий, скачать архив по ссылке и сверить контрольную сумму, удалить версию. Код выполняется в Node.js 18 и новее: сохраните его в файл с расширением .mjs, положите рядом архив app-sources.tar.gz, подставьте идентификатор приложения вместо <APP_ID> и передайте ключ в переменной окружения VIBE_KEY.

import { readFile } from 'node:fs/promises'
import { createHash } from 'node:crypto'

const VIBE_KEY = process.env.VIBE_KEY
const SOURCES = 'https://vibecode.bitrix24.tech/v1/apps/<APP_ID>/sources'

async function api(method, path = '', init = {}) {
  const res = await fetch(`${SOURCES}${path}`, {
    ...init,
    method,
    headers: { 'X-Api-Key': VIBE_KEY, ...init.headers },
  })
  const json = await res.json()
  if (!json.success) {
    throw new Error(`${method} ${path} → ${res.status} ${json.error.code}`)
  }
  return json.data
}

// 1. Сохранить снапшот: тело — сырые байты архива,
//    длину тела fetch указывает сам
const archive = await readFile(
  new URL('./app-sources.tar.gz', import.meta.url),
)
const saved = await api('POST', '', {
  headers: { 'Content-Type': 'application/gzip' },
  body: archive,
})
if (saved.skipped) {
  throw new Error(`Хранилище выключено: ${saved.reason}`)
}
console.log(
  'Версия:', saved.versionId,
  '| deduplicated:', saved.deduplicated,
)

// 2. Посмотреть список версий приложения
const list = await api('GET')
console.log(
  'Всего версий:', list.totalVersions,
  '| текущая:', list.currentVersionId,
)

// 3. Получить ссылку на архив и скачать его —
//    ссылка действует 30 минут, ключ ей не нужен
const { url } = await api('GET', `/${saved.versionId}/download`)
const bytes = Buffer.from(await (await fetch(url)).arrayBuffer())
const sha256 = createHash('sha256').update(bytes).digest('hex')
console.log('Архив совпадает с сохранённым:', sha256 === saved.sha256)

// 4. Удалить версию, если её создал этот запуск. При deduplicated: true
//    сохранение вернуло уже существующую версию с теми же байтами —
//    её пример не трогает
if (!saved.deduplicated) {
  const deleted = await api('DELETE', `/${saved.versionId}`)
  console.log('Удалена версия:', deleted.versionId)
}

Справочник эндпоинтов

Снапшоты приложения:

Снапшоты сервера — то же семейство с ключом сервера, отличия и полный список путей на странице Серверные эндпоинты исходников.

Сводный реестр: GET /v1/me/sources — все владельцы снапшотов, доступные ключу, Реестр исходников.

Коды ошибок

Отказы, специфичные для хранилища исходников:

Полный справочник кодов API — Коды ошибок.

Смотрите также

• Ключи и авторизация
• Коды ошибок
• MCP для AI
• Деплой приложения
• Хранилище
• Удалить сервер