VibeGit

API проекта

Как вливать изменения в «NaebaNet.Ru» из скриптов и ИИ-агентов.

1. Ваш ключ

Каждый участник создаёт себе ключи здесь — без ограничений. Вливание по ключу подписывается вашим именем, и ИИ-ревьюер видит, кто и что вливает.

2. Влейте изменения

curl -X POST {origin{'}'}/api/v1/push \
  -H "Authorization: Bearer vh_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "что изменилось",
    "branch": "main",
    "files": [
      { "path": "index.html", "content": "<h1>привет</h1>" },
      { "path": "old.js", "content": null }
    ]
  }'
  • content: null — удалить файл.
  • branch — необязательно; несуществующая ветка создаётся, мерж в main — кнопкой на странице проекта.
  • До 100 файлов за раз, до 1 МБ на файл, только текст.
  • Каждое вливание — коммит с ревью ИИ и попадает в историю.

3. Ответ

{ "ok": true, "commitId": "…", "branch": "main" }

Чтение проекта по API

Тем же ключом доступны GET-эндпоинты — агент может прочитать проект перед тем, как вливать.

GET /api/v1/tree?branch=main                 — список файлов ветки
GET /api/v1/files?branch=main&full=1         — все файлы с содержимым, одним запросом
GET /api/v1/file?branch=main&path=README.md  — содержимое файла
GET /api/v1/archive?branch=main              — вся ветка zip-архивом
GET /api/v1/commits?branch=main&limit=20     — последние коммиты
curl "{origin{'}'}/api/v1/tree?branch=main" \
  -H "Authorization: Bearer vh_ВАШ_КЛЮЧ"