tgit/docs/dev/GITEA_API.md

Gitea API — шпаргалка

Gitea — основной репозиторий и трекер: HSE/tgit. SourceCraft — зеркало (ADR-010).

Кириллица в JSON: не собирать тело в curl -d '{...}' руками — ломается кодировка и экранирование. Тело собираем в Python (json.dumps(..., ensure_ascii=False)) в файл и отправляем --data @file.json.

set -a; . ./.env; set +a                     # GITEA_URL, GITEA_TOKEN, GITEA_USER, GITEA_REPO
G="$GITEA_URL/api/v1/repos/$GITEA_REPO"
A="Authorization: token $GITEA_TOKEN"
J="Content-Type: application/json; charset=utf-8"
alias curl='curl --retry 4 --retry-all-errors --retry-delay 2'

Сервер иногда рвёт SSH (Connection closed … port 2222) и медленно отвечает на запись — повторять, перед повторным POST проверять, не создалась ли сущность.

Issues

# мои открытые
curl -s -H "$A" "$G/issues?state=open&type=issues&assigned_by=$GITEA_USER"

# создать: {"title","body","labels":[id…],"milestone":id,"assignees":["$GITEA_USER"]}
curl -s -X POST -H "$A" -H "$J" "$G/issues" --data @issue.json

# обновить тело / закрыть
curl -s -X PATCH -H "$A" -H "$J" "$G/issues/NN" --data @body.json      # {"body": "..."}
curl -s -X PATCH -H "$A" -H "$J" "$G/issues/NN" -d '{"state":"closed"}'

# комментарий
curl -s -X POST -H "$A" -H "$J" "$G/issues/NN/comments" --data @comment.json   # {"body": "..."}

# метки и вехи — по id
curl -s -H "$A" "$G/labels"
curl -s -H "$A" "$G/milestones?state=all"

Зависимости (только через API, не текстом в теле)

# #NN зависит от #MM (MM блокирует NN)
curl -s -X POST -H "$A" -H "$J" "$G/issues/NN/dependencies" -d "{\"owner\":\"${GITEA_REPO%%/*}\",\"repo\":\"${GITEA_REPO##*/}\",\"index\":MM}"
curl -s -H "$A" "$G/issues/NN/dependencies"

Pull requests

# PR в dev (не в main!); тело — с "Closes #NN"
curl -s -X POST -H "$A" -H "$J" "$G/pulls" --data @pr.json     # {"head":"feat/NN-slug","base":"dev","title":"…","body":"…"}

# ветка ещё есть? пусто → PR смержен, не пушить
git ls-remote --heads origin <ветка>

Зеркало в SourceCraft

curl -s -H "$A" "$G/push_mirrors"                       # статус: last_update, last_error
curl -s -X POST -H "$A" "$G/push_mirrors-sync"          # синхронизировать сейчас

Зеркало — HTTPS (git.sourcecraft.dev) с токеном SourceCraft: SSH-зеркала на этом Gitea отключены. Синхронизация — на каждый push + раз в 8 часов. Зеркало перезаписывает SourceCraft целиком (--mirror): в SourceCraft ничего не пушим и не мержим — изменения пропадут.