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_ВАШ_КЛЮЧ"