Gitea 補足情報 swaggerの使い方 #2

Create Repositoryを試す

設定ファイルを修正して登録不可にしました。公開準備だね。

さて、前回の続きで、右下のAPIをクリックAuthorizeをしておく、

ここでuserをクリック、

ずーっと下の方へ行って、

この下側の”POST”をクリック(というかオープン)。

このようになるので、右上の“Try it out”をクリックして、パラメーターを入力する。Edit Valueをクリックすると、

のようになるので、必要な部分を入れる。以下のようにして、

{
  "auto_init": false,
  "default_branch": "main",
  "description": "this is a desc",
  "gitignores": "",
  "issue_labels": "",
  "license": "",
  "name": "newprogram",
  "object_format_name": "sha1",
  "private": true,
  "readme": "",
  "template": false,
  "trust_model": ""
}

Executeする。

result code=201でおけ。この例を実行するcurlコマンドが一番上の、

curl -X 'POST' \
  'http://ghost.mydns.jp:3000/api/v1/user/repos' \
  -H 'accept: application/json' \
  -H 'Authorization: token e7cf6920b79ba55aa88bacd00e9383axxxxxyyyyzzz' \
  -H 'Content-Type: application/json' \
  -d '{
  "auto_init": false,
  "default_branch": "main",
  "description": "this is a desc",
  "gitignores": "",
  "issue_labels": "",
  "license": "",
  "name": "newprogram",
  "object_format_name": "sha1",
  "private": true,
  "readme": "",
  "template": false,
  "trust_model": ""
}'

POSTに対して返ってきたJSONは、

{
  "id": 10,
  "owner": {
    "id": 1,
    "login": "nao",
    "login_name": "",
    "source_id": 0,
    "full_name": "",
    "email": "nao@ghost.mydns.jp",
    "avatar_url": "http://192.168.0.240:3000/avatars/bfbf3648c4df196491db378de8f12cd9",
    "html_url": "http://192.168.0.240:3000/nao",
    "language": "",
    "is_admin": false,
    "last_login": "0001-01-01T00:00:00Z",
    "created": "2025-09-23T14:35:47+09:00",
    "restricted": false,
    "active": false,
    "prohibit_login": false,
    "location": "",
    "website": "",
    "description": "",
    "visibility": "public",
    "followers_count": 0,
    "following_count": 0,
    "starred_repos_count": 0,
    "username": "nao"
  },
  "name": "newprogram",
  "full_name": "nao/newprogram",
  "description": "this is a desc",
  "empty": true,
  "private": true,
  "fork": false,
  "template": false,
  "mirror": false,
  "size": 27,
  "language": "",
  "languages_url": "http://192.168.0.240:3000/api/v1/repos/nao/newprogram/languages",
  "html_url": "http://192.168.0.240:3000/nao/newprogram",
  "url": "http://192.168.0.240:3000/api/v1/repos/nao/newprogram",
  "link": "",
  "ssh_url": "git@192.168.0.240:nao/newprogram.git",
  "clone_url": "http://192.168.0.240:3000/nao/newprogram.git",
  "original_url": "",
  "website": "",
  "stars_count": 0,
  "forks_count": 0,
  "watchers_count": 1,
  "open_issues_count": 0,
  "open_pr_counter": 0,
  "release_counter": 0,
  "default_branch": "main",
  "archived": false,
  "created_at": "2026-02-24T14:58:31+09:00",
  "updated_at": "2026-02-24T14:58:31+09:00",
  "archived_at": "1970-01-01T09:00:00+09:00",
  "permissions": {
    "admin": true,
    "push": true,
    "pull": true
  },
  "has_issues": true,
  "internal_tracker": {
    "enable_time_tracker": true,
    "allow_only_contributors_to_track_time": true,
    "enable_issue_dependencies": true
  },
  "has_wiki": true,
  "has_pull_requests": true,
  "has_projects": true,
  "projects_mode": "all",
  "has_releases": true,
  "has_packages": true,
  "has_actions": true,
  "ignore_whitespace_conflicts": false,
  "allow_merge_commits": true,
  "allow_rebase": true,
  "allow_rebase_explicit": true,
  "allow_squash_merge": true,
  "allow_fast_forward_only_merge": true,
  "allow_rebase_update": true,
  "default_delete_branch_after_merge": false,
  "default_merge_style": "merge",
  "default_allow_maintainer_edit": false,
  "avatar_url": "",
  "internal": false,
  "mirror_interval": "",
  "object_format_name": "sha1",
  "mirror_updated": "0001-01-01T00:00:00Z",
  "topics": [],
  "licenses": []
}

sign inしてブラウズすると、

リポジトリ nao/newprogramができている。中身は、

のように当然ながら空(empty)である。RRMから眺めると、

とリストされている。emptyなのでグレーアウトでおけ。

Gitea以外にも、Github,Gitlab,bitbucket等々がありますが、swagger程ではないにしてもAPIから色々なことを行う際の情報は得られます。

コメント