forgeplus/api_document.md at 72d8af8d7b0338b80802c71ed2bcf19730f46a43

101 KiB

Raw Blame History

# API文档 ## 基本介绍 ### 开发API服务地址： **** 响应状态说明: |字段|类型|说明| |-|-|-| |status |int |响应状态码，0:请求成功，-1: 请求失败| |message |string |响应说明 | ### API接口

用户注册(通过其他平台)

POST accounts/remote_register

示例

curl -X POST \
-d "email=2456233122@qq.com" \
-d "password=djs_D_00001" \
-d "username=16895620" \
-d "platform=forge" \
http://localhost:3000/api/accounts/remote_register  | jq

请求参数说明:

参数名	必选	类型	说明
email	是	string	邮箱
username	是	string	登录名
password	是	string	秘密
platform	否	string	用户来源的相关平台，取值范围['educoder', 'trustie', 'forge'], 默认值为forge

返回参数说明:

参数名	类型	说明
user	json object	返回数据
-- id	int	用户id
-- token	string	用户token

返回值

{
  "status": 0,
  "message": "success",
  "user": {
    "id": 36400,
    "token": "8c87a80d9cfacc92fcb2451845104f35119eda96"
  }
}

获取当前登录用户信息

GET api/users/me

示例

curl -X GET http://localhost:3000/api/users/me  | jq

返回参数说明:

参数名	类型	说明
user_id	int	用户id
username	string	用户名称
admin	boolean	是否为管理用户
login	string	登录名
image_url	string	用户头像

返回值

{
  "username": "18816895620",
  "login": "18816895620",
  "user_id": 36401,
  "image_url": "avatars/User/b",
  "admin": false
}

用户列表(带搜索功能)

GET api/users/list

示例

curl -X GET \
-d "limit=10" \
-d "search=18816895620"
http://localhost:3000/api/users/list  | jq

请求参数说明:

参数名	必选	类型	说明
page	否	int	页数，第几页
limit	否	int	每页多少条数据，默认15条
search	否	string	用户名、登录名匹配搜索

返回参数说明:

参数名	类型	说明
total_count	int	总用户条数
users	array
-- username	string	用户全名
-- login	string	用户登录名
-- user_id	int	用户id
-- image_url	string	用户头像

返回值

{
  "total_count": 1,
  "users": [
    {
      "username": "18816895620",
      "login": "18816895620",
      "user_id": 36401,
      "image_url": "avatars/User/b"
    }
  ]
}

获取项目类别列表(可根据名称搜素)

GET api/project_categories

示例

curl -X GET \
-d "name=大数据" \
http://localhost:3000/api/project_categories/  | jq

请求参数说明:

参数名	必选	类型	说明
name	否	string	类别名称

返回参数说明:

参数名	类型	说明
project_categories	array	返回数据
-- id	int	类别id
-- name	string	类别名称

返回值

{
  "project_categories": [
    {
      "id": 1,
      "name": "大数据"
    }
  ]
}

获取项目语言列表(可根据名称搜素)

GET api/project_languages

示例

curl -X GET \
-d "name=Ruby" \
http://localhost:3000/api/project_languages/  | jq

请求参数说明:

参数名	必选	类型	说明
name	否	string	类别名称

返回参数说明:

参数名	类型	说明
project_languages	array	返回数据
-- id	int	语言id
-- name	string	语言名称

返回值

{
  "project_languages": [
    {
      "id": 1,
      "name": "Ruby"
    }
  ]
}

获取.gitignore模板列表(可根据名称搜素)

GET api/ignores

示例

curl -X GET \
-d "name=Ada" \
http://localhost:3000/api/ignores/  | jq

请求参数说明:

参数名	必选	类型	说明
name	否	string	gitignore名称

返回参数说明:

参数名	类型	说明
ignores	array	返回数据
-- id	int	id
-- name	string	gitignore名称

返回值

{
  "ignores": [
    {
      "id": 1,
      "name": "Ada"
    }
  ]
}

获取开源许可证列表(可根据名称搜素)

GET api/licenses

示例

curl -X GET \
-d "name=AFL" \
http://localhost:3000/api/licenses/  | jq

请求参数说明:

参数名	必选	类型	说明
name	否	string	开源许可证名称

返回参数说明:

参数名	类型	说明
licenses	array	返回数据
-- id	int	id
-- name	string	开源许可证名称

返回值

{
  "licenses": [
    {
      "id": 57,
      "name": "AFL-1.2"
    },
    {
      "id": 76,
      "name": "AFL-3.0"
    },
    {
      "id": 214,
      "name": "AFL-1.1"
    },
    {
      "id": 326,
      "name": "AFL-2.1"
    },
    {
      "id": 350,
      "name": "AFL-2.0"
    }
  ]
}

创建项目

POST api/projects

示例

curl -X POST \
-d "user_id=36401" \
-d "name=hnfl_demo" \
-d "description=my first project" \
-d "repository_name=hnfl_demo" \
-d "project_category_id=1" \
-d "project_language_id=2" \
-d "ignore_id=2" \
-d "license_id=1" \
http://localhost:3000/api/projects/  | jq

请求参数说明:

参数名	必选	类型	说明
user_id	是	int	用户id或者组织id
name	是	string	项目名称
description	是	string	项目描述
repository_name	是	string	仓库名称, 只含有数字、字母、下划线不能以下划线开头和结尾，且唯一
project_category_id	是	int	项目类别id
project_language_id	是	int	项目语言id
ignore_id	否	int	gitignore相关id
license_id	否	int	开源许可证id
private	否	boolean	项目是否私有, true：为私有，false: 公开，默认为公开

返回参数说明:

参数名	类型	说明
id	int	id
name	string	项目名称

返回值

{
  "id": 3240,
  "name": "好项目"
}

新建镜像项目

POST api/projects/migrate

示例

curl -X POST \
-d "user_id=36408" \
-d "clone_addr=https://gitea.com/mx8090alex/golden.git" \
-d "name=golden_mirror1" \
-d "description=golden_mirror" \
-d "project_category_id=1" \
-d "project_language_id=2" \
http://localhost:3000/api/projects/migrate.json  | jq

请求参数说明:

参数名	必选	类型	说明
user_id	是	int	用户id或者组织id
name	是	string	项目名称
clone_addr	是	string	镜像项目clone地址
description	否	string	项目描述
repository_name	是	string	仓库名称, 只含有数字、字母、下划线不能以下划线开头和结尾，且唯一
project_category_id	是	int	项目类别id
project_language_id	是	int	项目语言id
is_mirror	否	boolean	是否设置为镜像， true：是， false：否，默认为否
auth_username	否	string	镜像源仓库的登录用户名
auth_password	否	string	镜像源仓库的登录秘密
private	否	boolean	项目是否私有, true：为私有，false: 非私有，默认为公开

返回参数说明:

参数名	类型	说明
id	int	id
name	string	项目名称

返回值

{
  "id": 3263,
  "name": "ni项目"
}

手动同步镜像

POST api/repositories/:id/sync_mirror

示例

curl -X POST http://localhost:3000/api/repositories/1244/sync_mirror  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	仓库id

返回参数说明:

参数名	类型	说明
status	int	状态码， 0:标识请求成功
message	string	服务端返回的信息说明

返回值

{
  "status": 0,
  "message": "success"
}

项目详情

GET /api/:namespace_id/:id

示例

curl -X GET http://localhost:3000/api/jasder/jasder_test  | jq

请求参数说明:

参数名	必选	类型	说明
namespace_id	是	string	用户登录名
id	是	string	项目标识identifier

返回参数说明:

参数名	类型	说明
id	int	id
name	string	项目名称
identifier	string	项目标识
is_public	boolean	项目是否公开， true:公开，false:私有
description	string	项目简介
repo_id	int	仓库id
repo_identifier	string	仓库标识

返回值

{
  "name": "ni项目",
  "identifier": "mirror_demo",
  "is_public": true,
  "description": "my first project mirror_demo",
  "repo_id": 75073,
  "repo_identifier": "mirror_demo"
}

项目详情(简版)

GET /api/:namespace_id/:id/simple

示例

curl -X GET http://localhost:3000/api/jasder/jasder_test/simple  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
id	int	id
name	string	项目名称
identifier	string	项目标识
is_public	boolean	项目是否公开， true:公开，false:私有
description	string	项目简介
repo_id	int	仓库id
repo_identifier	string	仓库标识

返回值

{
  "identifier": "jasder_test",
  "name": "jasder的测试项目",
  "id": 4967,
  "type": 0,
  "author": {
    "login": "jasder",
    "name": "姓名",
    "image_url": "avatars/User/b"
  }
}

编辑仓库信息

GET  /api/repositories/:id/edit.json

示例

curl -X GET http://localhost:3000/api/repositories/:id/edit.json | jq

返回参数说明:

参数名	类型	说明
identifier	string	仓库标识
project_id	int	项目id
project_name	string	项目名称
project_identifier	string	项目标识
project_description	string	项目简介
project_category_id	int	项目类别id
project_language_id	int	项目语言id
private	boolean	项目是否私有, true：为私有，false: 公开

返回值

{
  "identifier": "mirror_demo",
  "project_id": 3263,
  "project_name": "ni项目",
  "project_identifier": "mirror_demo",
  "project_description": "my first project mirror_demo",
  "project_category_id": 1,
  "project_language_id": 2,
  "private": false
}

修改项目信息

PATCH api/projects/:id

示例

curl -X PATCH \
-d "name=hnfl_demo" \
-d "description=my first project" \
-d "project_category_id=1" \
-d "project_language_id=2" \
-d "private=true" \
http://localhost:3000/api/projects/3263.json  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
name	否	string	项目名称
description	否	string	项目描述
project_category_id	否	int	项目类别id
project_language_id	否	int	项目语言id
default_branch	否	string	默认分支名称
private	否	boolean	项目是否私有, true：为私有，false: 公开，默认为公开

返回参数说明:

参数名	类型	说明
id	int	id
identifier	string	项目标识
name	string	项目名称
description	string	项目简介
project_category_id	int	项目类别id
project_language_id	int	项目语言id
private	否	boolean

返回值

{
  "id": 3263,
  "identifier": "mirror_demo",
  "name": "hnfl_demo",
  "description": "my first project",
  "project_category_id": 1,
  "project_language_id": 2,
  "is_public": true
}

删除项目

DELETE api/projects/:id

示例

curl -X DELETE http://localhost:3000/api/projects/3263.json  | jq

注：只有超级管理员和项目拥有者才能删除仓库

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	返回状态， 0: 表示操作成功
message	string	返回信息说明

返回值

{
  "status": 0,
  "message": "success"
}

项目添加成员

POST api/projects/:id/members

示例

curl -X POST \
-d "user_id=36406" \
http://localhost:3000/api/projects/3297/members  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
user_id	是	int	用户id

返回参数说明:

参数名	类型	说明
status	int	0:添加成功， -1: 添加失败， 1: 表示已经是项目成员
message	string	返回信息说明

返回值

{
  "status": 0,
  "message": "success"
}

项目删除成员

DELETE api/projects/:id/members/remove

示例

curl -X DELETE \
-d "user_id=36400" \
http://localhost:3000/api/projects/3263/members/remove  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
user_id	是	int	用户id

返回参数说明:

参数名	类型	说明
status	int	0:移除成功， -1: 移除失败， 1: 表示还不是项目成员
message	string	返回信息说明

返回值

{
  "status": 0,
  "message": "success"
}

更改项目成员角色/权限

PUT api/projects/:id/members/change_role

示例

curl -X PUT \
-d "user_id=36400" \
-d "role=Developer" \
http://localhost:3000/api/projects/3263/members/change_role  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
user_id	是	int	用户id
role	是	string	取值范围："Manager", "Developer", "Reporter"；分别为项目管理人员(拥有所有操作权限)、项目开发人员(只拥有读写权限)、项目报告人员(只拥有读权限)

返回参数说明:

参数名	类型	说明
status	int	0:角色更改成功， -1: 更改失败失败， 1: 表示还不是项目成员
message	string	返回信息说明

返回值

{
  "status": 0,
  "message": "success"
}

项目成员列表

GET api/projects/:id/members

示例

curl -X GET \
-d "page=1" \
-d "limit=5" \
http://localhost:3000/api/projects/3263/members  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认15条

返回参数说明:

参数名	类型	说明
total_count	int	返回记录总条数
members	array	项目成员信息
-- id	int	用户id
-- name	string	用户名称
-- login	string	用户登录名/标识
-- image_url	string	用户头像
-- is_owner	boolean	是否是项目的拥有者，true:是， false:不是
-- role	string	该用户在项目中的角色， Manager: 管理员(拥有操作权限); Developer:开发人员(只拥有读写权限)； Reporter:报告人员(只拥有读权限)

返回值

{
  "total_count": 2,
  "members": [
    {
      "id": 36401,
      "name": "18816895620",
      "login": "18816895620",
      "image_url": "avatars/User/b",
      "is_owner": true,
      "role": "Manager"
    },
    {
      "id": 36399,
      "name": "18816365620",
      "login": "18816365620",
      "image_url": "avatars/User/b",
      "is_owner": false,
      "role": "Developer"
    }
  ]
}

Fork项目

POST /api/projects/:project_id/forks

示例

curl -X POST http://localhost:3000/api/projects/3297/forks  | jq

请求参数说明:

参数名	必选	类型	说明
project_id	是	int	项目id

返回参数说明:

参数名	类型	说明
id	int	项目id
identifier	string	项目标识

返回值

{
  "id": 3290,
  "identifier": "newadm"
}

获取代码目录列表

POST /api/:namespace_id/:project_id/repository/entries

示例

curl -X GET \
-d "ref=develop" \
http://localhost:3000//api/jasder/jasder_test/repository/entries  | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
ref	否	string	分支名称、tag名称或是提交记录id，默认为master分支

返回参数说明:

参数名	类型	说明
last_commit	object
-- commit	object
id	int	id
name	string	文件夹或文件名称
path	string	文件夹或文件相对路径
type	string	文件类型， file:文件，dir：文件目录
size	int	文件夹或文件大小单位B
content	string	文件内容，
target	string	标签

返回值

{
  "last_commit": {
    "commit": {
      "sha": "3f2de4f78d2d7050486535082cd11cdfc9f3679e",
      "url": "http://localhost:3003//api/repositories/api-cloud-platform/commits/3f2de4f78d2d7050486535082cd11cdfc9f3679e",
      "message": "update README.md.",
      "author": {
        "name": "Gitee",
        "email": "noreply@gitee.com",
        "date": "2020-03-02T20:23:18+08:00"
      },
      "committer": {
        "name": "Gitee",
        "email": "noreply@gitee.com",
        "date": "2020-03-02T20:23:18+08:00"
      },
      "timestamp": 1583151798,
      "time_from_now": "3个月前"
    },
    "author": null,
    "committer": null
  },
  "entries": [
    {
      "name": "ace-gate",
      "path": "ace-gate",
      "sha": "c83f85fc63b14edcd6fc502eee9996f5a9993eca",
      "type": "dir",
      "size": 0,
      "content": null,
      "target": null,
      "commit": {
        "message": "v2.9 升级alibaba组件release版本\n",
        "sha": "6117eaab86f71115f42f2a46ff1683015cda798d",
        "created_at": "1970-01-01 08:00",
        "time_from_now": "51年前",
        "created_at_unix": null
      }
    },
    {
      "name": "ace-sidecar",
      "path": "ace-sidecar",
      "sha": "38e41d7810876b464f8f1adcbf998e1b04f710a7",
      "type": "dir",
      "size": 0,
      "content": null,
      "target": null,
      "commit": {
        "message": "[Feature] 升级spring 版本&consul注册中心\n",
        "sha": "c0a5dde35cfc87f7dbaf676aac397b184ba0e55b",
        "created_at": "1970-01-01 08:00",
        "time_from_now": "51年前",
        "created_at_unix": null
      }
    },
    ...
  ]
}

获取子目录代码列表/编辑某个具体的文件

GET /api/repositories/:id/sub_entries

示例

curl -X GET \
-d "ref=master" \
-d "filepath=test1_create_file.rb" \
http://localhost:3000/api/repositories/87/sub_entries.json | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
filepath	是	string	文件夹、文件的相对路径
ref	否	string	分支名称、tag名称或是提交记录id，默认为master分支

返回参数说明:

参数名	类型	说明
id	int	id
name	string	文件夹或文件名称
path	string	文件夹或文件相对路径
type	string	文件类型， file:文件，dir：文件目录
size	int	文件夹或文件大小单位KB
content	string	文件内容，
target	string	标签
url	string	文件访问链接,带分支
html_url	string	文件访问链接，未标识分支
git_url	string	文件夹或文件的git仓库访问链接
download_url	string	文件下载、文件内容访问链接

返回值

[
  {
    "name": "build.rc",
    "path": "lib/build.rc",
    "type": "",
    "size": 1268,
    "content": null,
    "target": null,
    "url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/contents/lib/build.rc?ref=master",
    "html_url": "http://localhost:3003/18816895620/mirror_demo/src/branch/master/lib/build.rc",
    "git_url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/git/blobs/191fcf1a63b3777e2977fcede7dd5309efdd70fe",
    "download_url": null
  },
  {
    "name": "cfg.rc",
    "path": "lib/cfg.rc",
    "type": "file",
    "size": 107,
    "content": null,
    "target": null,
    "url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/contents/lib/cfg.rc?ref=master",
    "html_url": "http://localhost:3003/18816895620/mirror_demo/src/branch/master/lib/cfg.rc",
    "git_url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/git/blobs/0b91ba0ed1c00e130c77bb9058af3787fea986a0",
    "download_url": "http://localhost:3003/18816895620/mirror_demo/raw/branch/master/lib/cfg.rc"
  },
  {
    "name": "fn",
    "path": "lib/fn",
    "type": "dir",
    "size": 0,
    "content": null,
    "target": null,
    "url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/contents/lib/fn?ref=master",
    "html_url": "http://localhost:3003/18816895620/mirror_demo/src/branch/master/lib/fn",
    "git_url": "http://localhost:3003/api/v1/repos/18816895620/mirror_demo/git/blobs/e33bd45949ef8f804471d0b6b2c59728eb445989",
    "download_url": null
  }
]

项目类别列表(用于项目列表左侧导航中的项目类别列表)

GET api/project_categories/group_list

示例

curl -X GET http://localhost:3000/api/project_categories/group_list | jq

返回参数说明:

参数名	类型	说明
id	int	项目分类id
name	string	项目分类名称
projects_count	int	项目数量

返回值

[
  {
    "id": 1,
    "name": "大数据",
    "projects_count": 30
  },
  {
    "id": 2,
    "name": "机器学习",
    "projects_count": 1
  },
  {
    "id": 3,
    "name": "深度学习",
    "projects_count": 1
  }
]

项目类型列表(用于项目列表左侧导航上方中的项目类型列表)

GET api/projects/group_type_list

示例

curl -X GET http://localhost:3000/api/projects/group_type_list | jq

返回参数说明:

参数名	类型	说明
project_type	string	项目类型
name	string	项目类型名称
projects_count	int	项目数量

返回值

[
  {
    "project_type": "common",
    "name": "开源托管项目",
    "projects_count": 2106
  },
  {
    "project_type": "mirror",
    "name": "开源镜像项目",
    "projects_count": 1
  }
]

项目列表

GET api/projects

示例

curl -X GET \
-d "page=1" \
-d "limit=5" \
http://localhost:3000/api/projects  | jq

请求参数说明:

参数名	必选	类型	说明
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认15条
sort_by	否	string	排序类型, 取值：updated_on \| created_on \| forked_count \| praises_count, updated_on: 更新时间排序，created_on: 创建时间排序，forked_count: fork数据排序，praises_count: 点赞数量排序，默认为updated_on更新时间排序
sort_direction	否	string	排序方式,取值为: desc \| asc; desc: 降序排序， asc: 升序排序，默认为：desc
search	否	string	按照项目名称搜索
category_id	否	int	项目类别id
language_id	否	int	项目语言id
project_type	否	string	项目类型，取值为：common \| mirror; common:开源托管项目, mirror:开源镜像项目

返回参数说明:

参数名	类型	说明
total_count	int	项目总条数
id	string	项目id
name	string	项目名称
description	string	项目简介
visits	int	流量数
forked_count	int	被fork的数量
praises_count	int	star数量
is_public	boolean	是否公开， true:公开，false:未公开
mirror_url	string	镜像url
last_update_time	int	最后更新时间，为UNIX格式的时间戳
author	object	项目创建者
-- name	string	用户名，也是用户标识
category	object	项目类别
-- id	int	项目类型id
-- name	string	项目类型名称
language	object	项目语言
-- id	int	项目语言id
-- name	string	项目语言名称

返回值

{
  "total_count": 3096,
  "projects": [
    {
      "id": 1,
      "name": "hnfl_demo1",
      "description": "my first project",
      "visits": 0,
      "praises_count": 0,
      "forked_count": 0,
      "is_public": true,
      "mirror_url": null,
      "last_update_time": 1577697461,
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      },
      "category": {
        "id": 1,
        "name": "大数据"
      },
      "language": {
        "id": 2,
        "name": "C"
      }
    },
    {
      "id": 2,
      "name": "hnfl_demo",
      "description": "my first project",
      "visits": 0,
      "praises_count": 0,
      "forked_count": 0,
      "is_public": true,
      "mirror_url": null,
      "last_update_time": 1577697403,
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      },
      "category": {
        "id": 1,
        "name": "大数据"
      },
      "language": {
        "id": 2,
        "name": "C"
      }
    },
    {
      "id": 3,
      "name": "统计局",
      "description": "my first project",
      "visits": 0,
      "praises_count": 0,
      "forked_count": 0,
      "is_public": true,
      "mirror_url": null,
      "last_update_time": 1577415173,
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      },
      "category": {
        "id": 1,
        "name": "大数据"
      },
      "language": {
        "id": 2,
        "name": "C"
      }
    },
    {
      "id": 5,
      "name": "开源同名",
      "description": "my first project",
      "visits": 0,
      "praises_count": 0,
      "forked_count": 0,
      "is_public": false,
      "mirror_url": "https://gitea.com/CasperVector/slew.git",
      "last_update_time": 1577346228,
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      },
      "category": {
        "id": 1,
        "name": "大数据"
      },
      "language": {
        "id": 2,
        "name": "C"
      }
    },
    {
      "id": 7,
      "name": "开源支持",
      "description": "my first project",
      "visits": 0,
      "praises_count": 0,
      "forked_count": 0,
      "is_public": true,
      "mirror_url": null,
      "last_update_time": 1577341572,
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      },
      "category": {
        "id": 1,
        "name": "大数据"
      },
      "language": {
        "id": 2,
        "name": "C"
      }
    }
  ]
}

项目主页

GET api/:namespace_id/:id/about

示例

curl -X GET \
http://localhost:3000/api/:jason/forgeplus/about  | jq

请求参数说明:

参数名	必选	类型	说明
namespace_id	是	string	用户登录名
id	是	string	项目标识identifier

返回参数说明:

参数名	类型	说明
identifier	string	project's identifier
content	string	主页内容
attachments	array	附件
-- name	string	用户名，也是用户标识

返回值

{
  "content": "",
  "identifier": "forgeplus",
  attachments: [

  ]
}

修改项目主页内容

POST api/:namespace_id/:id/about

示例

curl -X POST \
-d "content=内容" \
-d "attachment_ids=[1, 2, 2]" \
http://localhost:3000/api/:jasder/forgeplus/about  | jq

请求参数说明:

参数名	必选	类型	说明
namespace_id	是	string	用户登录名
id	是	string	项目标识identifier
content	是	string	内容信息
attachment_ids	是	array	附件id

返回参数说明:

参数名	类型	说明
identifier	string	project's identifier
content	string	主页内容
attachments	array	附件
-- name	string	用户名，也是用户标识

返回值

{
  "content": "",
  "identifier": "forgeplus",
  attachments: [

  ]
}

获取分支列表

GET /api/:namespace_id/:id/branches

示例

curl -X GET http://localhost:3000/api/jasder/jasder_test/branches | jq

请求参数说明:

参数名	必选	类型	说明
id	是	id	项目id

返回参数说明:

参数名	类型	说明
name	string	分支名称
user_can_push	boolean	用户是否可push
user_can_merge	boolean	用户是否客merge
protected	boolean	是否为保护分支
http_url	boolean	http链接
zip_url	boolean	zip包下载链接
tar_url	boolean	tar.gz下载链接
last_commit	object	最后提交记录
-- id	string	提交记录id
-- message	string	提交的说明信息
-- timestamp	int	提交时间，为UNIX时间戳
-- time_from_now	string	转换后的时间
author	object	提交用户
-- login	string	用户名称
-- image_url	string	用户头像

返回值

[
  {
    "name": "develop",
    "user_can_push": true,
    "user_can_merge": true,
    "protected": false,
    "http_url": "http://localhost:3003/18816895620/mirror_demo.git",
    "zip_url": "http://localhost:3003/18816895620/mirror_demo/develop.zip",
    "tar_url": "http://localhost:3003/18816895620/mirror_demo/develop.tar.gz",
    "last_commit": {
      "id": "735674d6696bddbafa993db9c67b40c41246c77f",
      "message": "FIX test branch content\n",
      "timestamp": 1577694074,
      "time_from_now": "1天前"
    },
    "author": {
      "login": "18816895620",
      "image_url": "avatars/User/b"
    }
  },
  {
    "name": "master",
    "user_can_push": true,
    "user_can_merge": true,
    "protected": false,
    "http_url": "http://localhost:3003/18816895620/mirror_demo.git",
    "zip_url": "http://localhost:3003/18816895620/mirror_demo/master.zip",
    "tar_url": "http://localhost:3003/18816895620/mirror_demo/master.tar.gz",
    "last_commit": {
      "id": "19ac3bc45f62cc87a94b8ecce61101d8fd2dafd2",
      "message": "合并pull request测试\n\n该功能很不错，感谢你的建议\n",
      "timestamp": 1577244567,
      "time_from_now": "6天前"
    },
    "author": {
      "login": "18816895620",
      "image_url": "avatars/User/b"
    }
  }
]

获取代码库标签列表

GET  /api/repositories/:id/tags

示例

curl -X GET \
-d "limit=20" \
-d "page=1" \
http://localhost:3000/api/repositories/5836/tags.json | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	仓库id
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认20条

返回参数说明:

参数名	类型	说明
name	string	分支名称
user_can_push	boolean	用户是否可push
user_can_merge	boolean	用户是否客merge
protected	boolean	是否为保护分支
http_url	boolean	http链接
zip_url	boolean	zip包下载链接
tar_url	boolean	tar.gz下载链接
last_commit	object	最后提交记录
-- id	string	提交记录id
-- message	string	提交的说明信息
-- timestamp	int	提交时间，为UNIX时间戳
-- time_from_now	string	转换后的时间
author	object	提交用户
-- login	string	用户名称
-- image_url	string	用户头像

返回值

[
  {
    "name": "develop",
    "user_can_push": true,
    "user_can_merge": true,
    "protected": false,
    "http_url": "http://localhost:3003/18816895620/mirror_demo.git",
    "zip_url": "http://localhost:3003/18816895620/mirror_demo/develop.zip",
    "tar_url": "http://localhost:3003/18816895620/mirror_demo/develop.tar.gz",
    "last_commit": {
      "id": "735674d6696bddbafa993db9c67b40c41246c77f",
      "message": "FIX test branch content\n",
      "timestamp": 1577694074,
      "time_from_now": "1天前"
    },
    "author": {
      "login": "18816895620",
      "image_url": "avatars/User/b"
    }
  },
  {
    "name": "master",
    "user_can_push": true,
    "user_can_merge": true,
    "protected": false,
    "http_url": "http://localhost:3003/18816895620/mirror_demo.git",
    "zip_url": "http://localhost:3003/18816895620/mirror_demo/master.zip",
    "tar_url": "http://localhost:3003/18816895620/mirror_demo/master.tar.gz",
    "last_commit": {
      "id": "19ac3bc45f62cc87a94b8ecce61101d8fd2dafd2",
      "message": "合并pull request测试\n\n该功能很不错，感谢你的建议\n",
      "timestamp": 1577244567,
      "time_from_now": "6天前"
    },
    "author": {
      "login": "18816895620",
      "image_url": "avatars/User/b"
    }
  }
]

仓库详情

GET /api/:namespace_id/:project_id/repository

示例

curl -X GET \
http://192.168.2.230:3000/api/jasder/forgeplus/repository | jq

请求参数说明:

参数名	必选	类型	说明
namespace_id	是	string	用户登录名
project_id	是	string	项目标识identifier

返回参数说明:

参数名	类型	说明
identifier	string	仓库标识
project_id	int	项目id
project_identifier	string	项目标识
praises_count	int	点赞数量
forked_count	int	fork数量
watchers_count	int	关注数量
branches_count	int	分支数量
commits_count	int	总提交记录数量
issues_count	int	总提交记录数量
pull_requests_count	int	总提交记录数量
praised	boolean	当前登录用户是否已点赞，true:已点赞，fasle:未点赞，用户未登录状态为null
watched	boolean	当前登录用户是否已关注，true:已关注，fasle:未关注，用户未登录状态为null
permission	string	当前登录用户对该仓库的操作权限, Manager:管理员，可以在线编辑文件、在线新建文件、可以设置仓库的基本信息; Developer:开发人员，可在线编辑文件、在线新建文件、不能设置仓库信息; Reporter: 报告人员，只能查看信息，不能设置仓库信息、不能在线编辑文件、不能在线新建文件；用户未登录时也会返回Reporter, 说明也只有读取文件的权限
size	int	仓库文件大小，单位：KB
type	int	项目类型; 2: 表示是一个镜像(具备同步功能), 1: 普通镜像项目(不具同步功能), 0: 普通托管项目, 3: fork项目
mirror_status	int	该字段在type字段为2(一个镜像)时才会出现; 0: 表示同步镜像成功；1: 表示正在同步镜像；2: 同步失败
mirror_url	string	镜像地址, 只有通过镜像过来的项目才会有这个地址
ssh_url	string	仓库ssh地址
clone_url	string	仓库克隆地址
empty	boolean	仓库是否为空，true: 空仓库；false: 非空仓库
private	boolean	仓库是否私有，true: 私有仓库；fasle: 非私有的
default_branch	string	仓库默认分支
full_name	string	仓库全名(带用户名)
author	object	提交用户
-- login	string	用户login
-- name	string	用户姓名
-- image_url	string	用户头像

返回值

{
  "identifier": "mirror_demo",
  "project_id": 3263,
  "project_identifier": "mirror_demo",
  "praises_count": 1,
  "forked_count": 0,
  "watchers_count": 1,
  "branches_count": 6,
  "commits_count": 107,
  "issues_count": 0,
  "pull_requests_count": 0,
  "permission": "Manager",
  "mirror_url": "https://gitea.com/CasperVector/slew.git",
  "watched": true,
  "praised": true,
  "size": 446,
  "ssh_url": "jasder@localhost:18816895620/mirror_demo.git",
  "clone_url": "http://localhost:3003/18816895620/mirror_demo.git",
  "default_branch": "master",
  "empty": false,
  "full_name": "18816895620/mirror_demo",
  "mirror": false,
  "private": false,
  "author": {
    "login": "18816895620",
    "name": "美女",
    "image_url": "avatars/User/b"
  }
}

获取提交记录列表

GET  /api/repositories/:id/commits

示例

curl -X GET \
-d "sha=develop" \
-d "page=1" \
http://localhost:3000/api/repositories/89/commits.json | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
sha	否	string	分支名称、提交记录的sha标识，默认为master分支
page	否	int	页数，默认为1

返回参数说明:

参数名	类型	说明
total_count	int	总记录条数
commits	array	提交记录的数组
-- sha	string	提交记录sha标识
-- message	string	提交的备注说明
-- timestamp	int	提交UNIX时间戳
-- time_from_now	string	提交距离当前的时间
author	object	提交用户
-- login	string	用户名称
-- image_url	string	用户头像

返回值

{
  "total_count": 63,
  "commits": [
    {
      "sha": "19ac3bc45f62cc87a94b8ecce61101d8fd2dafd2",
      "message": "合并pull request测试",
      "timestamp": 1577244567,
      "time_from_now": "7天前",
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      }
    },
    {
      "sha": "2b33c5f55214db41879936312ee43611406c4dbd",
      "message": "FIX .",
      "timestamp": 1577244474,
      "time_from_now": "7天前",
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      }
    }
  ]
}

获取某个提交记录(包含diff)

GET  /api/:owner/:repo/commits/:sha

示例

curl -X GET \
http://localhost:3000/api/jasder/repo/commits/b0c4a4a1487d53acebf2addc544b29938cad12df.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	仓库拥有者
repo	是	string	仓库的identifier值
sha	否	string	git的ref或者是提交记录commit的sha标识

返回参数说明: 请参考compare接口

返回值

{
  "files_count": 6,
  "total_addition": 447,
  "total_deletion": 0,
  "commit": {
    "sha": "8f5faee0d3b3be1b8063e84da0c79dd75327b968",
    "message": "add some file\n* Add the tag list page to the release page\n* Apply suggestions from code review\n* Add the tags list view\n* Add the delete tag way on ui\n* Not delete tag and clear message when delete a release\n",
    "author": {
      "name": "Jasder",
      "email": "2053003901@@qq.com",
      "date": "2020-11-03T13:56:22+08:00"
    },
    "committer": {
      "name": "Jasder",
      "email": "2053003901@@qq.com",
      "date": "2020-11-03T13:56:22+08:00"
    },
    "timestamp": 1604382982,
    "time_from_now": "3天前"
  },
  "author": null,
  "committer": null,
  "parents": [
    {
      "sha": "c7f5b90725f30d8ad840a026773f9df92debc3af"
    },
  "files": [
    {
      "name": "build.go",
      "old_name": "build.go",
      "index": 1,
      "addition": 33,
      "deletion": 0,
      "type": 1,
      "isCreated": true,
      "isDeleted": false,
      "isBin": false,
      "isLFSFile": false,
      "isRenamed": false,
      "isSubmodule": false,
      "sections": [
        {
          "fileName": "build.go",
          "name": "",
          "lines": [
            {
              "leftIdx": 0,
              "rightIdx": 0,
              "type": 4,
              "content": "@@ -0,0 +1,33 @@",
              "sectionInfo": {
                "path": "build.go",
                "lastLeftIdx": 0,
                "lastRightIdx": 0,
                "leftIdx": 0,
                "rightIdx": 1,
                "leftHunkSize": 0,
                "rightHunkSize": 33
              }
            },
            {
              "leftIdx": 0,
              "rightIdx": 1,
              "type": 2,
              "content": "+// Copyright 2020 The Gitea Authors. All rights reserved.",
              "sectionInfo": null
            }
          ]
        }
      ]
    }
  ]
}

POST /api/projects/:id/praise_tread/like

示例

curl -X POST http://localhost:3000/api/projects/3263/praise_tread/like | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	0:点赞成功，-1:操作失败，2:表示已经点过赞了

返回值

{
    "status": 0,
    "message": "success"
}

取消点赞

DELETE /api/projects/:id/praise_tread/unlike

示例

curl -X DELETE http://localhost:3000/api/projects/3263/praise_tread/unlike | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	0:点赞成功，-1:操作失败，2:表示还未点赞

返回值

{
  "status": 0,
  "message": "success"
}

用户是否点过赞

GET /api/projects/:id/praise_tread/check_like

示例

curl -X GET http://localhost:3000/api/projects/3263/praise_tread/check_like | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	1:已点过赞，0:未点过赞, -1:请求操作失败

返回值

{
  "status": 0,
  "message": "success"
}

项目的点赞者列表

GET /api/projects/:id/praise_tread

示例

curl -X GET \
-d "page=1" \
-d "limit=5" \
http://localhost:3000/api/projects/3263/praise_tread | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认15条

返回参数说明:

参数名	类型	说明
total_count	int	总条数
praises	array	点赞数据
-- name	string	用户名称
-- login	string	用户标识/登录名(login)
-- image_url	string	用户头像

返回值

{
  "total_count": 1,
  "praises": [
    {
      "name": "18816895620",
      "login": "18816895620",
      "image_url": "avatars/User/b"
    }
  ]
}

关注(项目)

POST /api/projects/:id/watchers/follow

示例

curl -X POST http://localhost:3000/api/projects/3263/watchers/follow | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	0:点赞成功，-1:操作失败，2:表示已经点过赞了

返回值

{
    "status": 0,
    "message": "响应成功"
}

取消关注

DELETE /api/projects/:id/watchers/unfollow

示例

curl -X DELETE http://localhost:3000//api/projects/3263/watchers/unfollow | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	0:点赞成功，-1:操作失败，2:表示还未点赞

返回值

{
  "status": 0,
  "message": "响应成功"
}

用户是否关注过项目

GET /api/projects/:id/watchers/check_watch

示例

curl -X GET http://localhost:3000/api/projects/3263/watchers/check_watch | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id

返回参数说明:

参数名	类型	说明
status	int	1:已关注，0:未关注, -1:请求操作失败

返回值

{
  "status": 0,
  "message": "success"
}

项目的关注者列表

GET /api/projects/:id/watchers

示例

curl -X GET \
-d "page=1" \
-d "limit=5" \
http://localhost:3000//api/projects/3263/watchers | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认15条

返回参数说明:

参数名	类型	说明
total_count	int	总条数
watchers	array	关注数据
-- name	string	用户名称
-- login	string	用户标识/登录名(login)
-- image_url	string	用户头像

返回值

{
  "total_count": 1,
  "watchers": [
    {
      "name": "18816895620",
      "login": "18816895620",
      "image_url": "avatars/User/b"
    }
  ]
}

仓库新建文件

POST /api/repositories/:id/create_file

示例

curl -X POST \
-d 'filepath=test1_create_file1.rb' \
-d 'branch=master' \
-d 'content=提交的内容' \
-d 'message=test commit ' \
http://localhost:3000/api/18816895620/mirror_demo/contents.json | jq

请求参数说明:

参数名	必选	类型	说明
id	是	string	项目id
filepath	是	string	文件相对于仓库的路径
content	否	string	内容
message	否	string	提交说明
branch	否	string	分支名称, branch和new_branch必须存在一个
new_branch	否	string	新的分支名称

返回参数说明:

参数名	类型	说明
name	string	文件名
sha	string	提交文件的sha值
size	int	文件大小，单位：B
content	string	base64编码后的文件内容
encoding	string	编码方式
commit	object
-- message	string	提交备注说明信息
-- committer	object
---- name	string	用户名
---- email	string	用户邮箱
---- date	string	文件创建时间

返回值

{
  "name": "test1_create_file12.rb",
  "sha": "7b70509105b587e71f5692b9e8ab70851e321f64",
  "size": 12,
  "content": "Wm5ObWMyRmtaZz09",
  "encoding": "base64",
  "commit": {
    "message": "good luck\n",
    "author": {
      "name": "18816895620",
      "email": "2456233122@qq.com",
      "date": "2020-01-07T03:31:20Z"
    },
    "committer": {
      "name": "18816895620",
      "email": "2456233122@qq.com",
      "date": "2020-01-07T03:31:20Z"
    }
  }
}

更新仓库中的文件

PUT /api/repositories/:id/update_file.json

示例

curl -X PUT \
-d 'filepath=text1.rb' \
-d 'branch=master' \
-d 'content=ruby code' \
-d 'message=更改提交信息' \
-d 'from_path=text.rb' \
-d "sha=57426eb21e4ceabdf4b206f022077e0040" \
http://localhost:3000/api/repositories/3938/update_file.json | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
filepath	是	string	文件相对于仓库的路径(或修改后的文件路径)
from_path	是	string	原文件相对于仓库的路径, 只有当需要修改原文件名称时，才需要该参数
sha	是	string	文件的sha标识值
content	是	string	内容
message	否	string	提交说明
branch	否	string	分支名称, branch和new_branch必须存在一个,且只能存在一个
new_branch	否	string	新的分支名称

返回参数说明:

参数名	类型	说明
name	string	文件名
sha	string	提交文件的sha值
size	int	文件大小，单位：B
content	string	base64编码后的文件内容
encoding	string	编码方式
commit	object
-- message	string	提交备注说明信息
-- committer	object
---- name	string	用户名
---- email	string	用户邮箱
---- date	string	文件创建时间

返回值

{
  "name": "test1_create_file6.rb",
  "sha": "57426eb21e4ceabdf4b206f022257e08077e0040",
  "size": 16,
  "content": "5o+Q5Lqk55qE5YaF5a65MQ==",
  "encoding": "base64",
  "commit": {
    "message": "更改提交信息\n",
    "author": {
      "name": "18816895620",
      "email": "2456233122@qq.com",
      "date": "2020-01-08T07:05:15Z"
    },
    "committer": {
      "name": "18816895620",
      "email": "2456233122@qq.com",
      "date": "2020-01-08T07:05:15Z"
    }
  }
}

删除仓库中的文件

DELETE /api/repositories/:id/delete_file

示例

curl -X DELETE \
-d 'filepath=test1_create_file12.rb' \
-d 'test delete file' \
-d 'sha=7b70509105b587e71f5692b9e8ab70851e321f64' \
http://localhost:3000/api//api/repositories/3868/delete_file | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	项目id
filepath	是	string	文件相对于仓库的路径
message	否	string	提交说明
branch	否	string	分支名称, 默认为master分支
new_branch	否	string	新的分支名称

返回参数说明:

参数名	类型	说明
sha	string	提交文件的sha值
commit	object
-- message	string	提交备注说明信息
-- committer	object
---- name	string	用户名
---- email	string	用户邮箱
---- date	string	文件创建时间

返回值

{
  "commit": {
    "sha": "7b70509105b587e71f5692b9e8ab70851e321f64",
    "message": "Delete 'test1_create_file11.rb'\n",
    "author": {
      "name": "18816895620",
      "email": "2456233122@qq.com",
      "date": "2020-01-08T07:57:34Z"``
    },
    "committer": {
      "name": "18816895620",
      "email": "2456233122@qq.com",
      "date": "2020-01-08T07:57:34Z"
    }
  }
}

获取pull request文件列表

GET /api/:owner/:repo/pulls/:id/files.json

示例

curl -X GET \
http://localhost:3000/api/Jason/test-txt/pulls/1/files.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier
id	是	int	pull request's id

返回参数说明:

参数名	类型	说明
files_count	int	文件更改的总数量
total_addition	int	添加代码总行数
total_deletion	int	删除代码总行数
files	array
-- sha	string	commit's sha value
-- name	string	当前文件名
-- old_name	string	修改之前的文件名称,与name相同的话，说明文件名未更改
-- addition	int	文件添加的行数
-- deletion	int	文件删除的行数
-- type	int	文件类型， 1: 表示该文件只添加了内容，2: 表示该文件内容有修改， 3: 表示文件被删除或者改文件只删除了内容
-- isCreated	boolean	当前文件是否为新增文件, true: 是， false: 否
-- isDeleted	boolean	当前文件是否被删除， true: 是，false: 否
-- isBin	boolean	当前文件是否为二进制文件，true: 是，false: 否
-- isLFSFile	boolean	当前文件是否为LFS文件，true: 是，false: 否
-- isRenamed	boolean	当前文件是否被重命名，true: 是，false: 否
-- sections	array
---- fileName	string	文件名称
---- lines	array
------ leftIdx	string	文件变动之前所在行数
------ rightIdx	string	文件更改后所在行数
------ type	string	文件变更类型，1: 新增，2: 修改， 3: 删除， 4: diff统计信息
------ content	string	文件变更的内容
------ sectionInfo	object
-------- path	string	文件相对仓库的路径
-------- lastLeftIdx	int
-------- lastRightIdx	int
-------- leftHunkSize	int	文件变更之前的行数
-------- rightHunkSize	int	文件变更之后的行数(及当前页面编辑器显示的总行数)
-------- leftIdx	int	文件变更之前所在行数
-------- rightIdx	int	文件变更之后所在行数(即：页面编辑器开始显示的行数)

返回值

{
  "files_count": 6,
  "total_addition": 447,
  "total_deletion": 0,
  "files": [
    {
      "sha": "xefenisnii",
      "name": "文件.txt",
      "old_name": "文件.txt",
      "index": 6,
      "addition": 2,
      "deletion": 0,
      "type": 1,
      "isCreated": true,
      "isDeleted": false,
      "isBin": false,
      "isLFSFile": false,
      "isRenamed": false,
      "isSubmodule": false,
      "sections": [
        {
          "fileName": "文件.txt",
          "name": "",
          "lines": [
            {
              "leftIdx": 0,
              "rightIdx": 0,
              "type": 4,
              "content": "@@ -0,0 +1,2 @@",
              "sectionInfo": {
                "path": null,
                "lastLeftIdx": null,
                "lastRightIdx": null,
                "leftIdx": 0,
                "rightIdx": 0,
                "leftHunkSize": null,
                "rightHunkSize": null
              }
            },
            {
              "leftIdx": 0,
              "rightIdx": 1,
              "type": 2,
              "content": "+用例图一致性更新",
              "sectionInfo": null
            },
            {
              "leftIdx": 0,
              "rightIdx": 2,
              "type": 2,
              "content": "+工程文件直接上传会有文件缺失，现在压缩后上传",
              "sectionInfo": null
            }
          ]
        }
      ]
    }
  ]
}

获取pull request的commits列表

GET /api/:owner/:repo/pulls/:id/commits.json

示例

curl -X GET \
http://localhost:3000/api/Jason/repo/1/commits.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier
id	是	int	pull request's id

返回参数说明:

参数名	类型	说明
commits_count	int	commits总数量
commits	array
-- author	object	项目作者
---- login	string	用户login
---- name	string	用户姓名
---- image_url	string	用户头像
-- committer	object	commit提交用户
---- login	string	用户login
---- name	string	用户姓名
---- image_url	string	用户头像
-- timestamp	int	commit的unix时间戳
-- time_from_now	string	commit’s 提交时间距当前时间的时间值
-- message	string	commit说明信息
-- sha	string	commit’s sha值

返回值

{
  "commits_count": 1,
  "commits": [
    {
      "author": {
        "id": 36480,
        "login": "jasder",
        "name": "段甲生",
        "image_url": "avatars/User/b"
      },
      "committer": {
        "id": 36480,
        "login": "jasder",
        "name": "段甲生",
        "image_url": "avatars/User/b"
      },
      "timestamp": 1604382982,
      "time_from_now": "3小时前",
      "message": "add some file\n* Add the tag list page to the release page\n* Apply suggestions from code review\n* Add the tags list view\n* Add the delete tag way on ui\n* Not delete tag and clear message when delete a release\n",
      "sha": "8f5faee0d3b3be1b8063e84da0c79dd75327b968"
    }
  ]
}

compare two commits

GET /api/:owner/:repo/compare/{base}...{head}.json

示例

curl -X GET \
http://localhost:3000/api/Jason/test-txt/compare/master...develop | jq

curl -X GET \
http://localhost:3000/api/ysfns/test-txt/compare/master...Jason/test-txt:develop

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier
base	是	string	pull request's id
head	是	string	pull request's id

返回参数说明:

参数名	类型	说明
commits_count	int	commits总数量
commits	array
-- author	object	项目作者
---- login	string	用户login
---- name	string	用户姓名
---- image_url	string	用户头像
-- committer	object	commit提交用户
---- login	string	用户login
---- name	string	用户姓名
---- image_url	string	用户头像
-- timestamp	int	commit的unix时间戳
-- time_from_now	string	commit’s 提交时间距当前时间的时间值
-- message	string	commit说明信息
-- sha	string	commit’s sha值
diff	object
-- files_count	int	文件更改的总数量
-- total_addition	int	添加代码总行数
-- total_deletion	int	删除代码总行数
-- files	Array
-- sha	string	commit's sha
-- name	string	当前文件名
-- old_name	string	修改之前的文件名称,与name相同的话，说明文件名未更改
-- addition	int	文件添加的行数
-- deletion	int	文件删除的行数
-- type	int	文件类型， 1: 表示该文件只添加了内容，2: 表示该文件内容有修改， 3: 表示文件被删除或者改文件只删除了内容
-- isCreated	boolean	当前文件是否为新增文件, true: 是， false: 否
-- isDeleted	boolean	当前文件是否被删除， true: 是，false: 否
-- isBin	boolean	当前文件是否为二进制文件，true: 是，false: 否
-- isLFSFile	boolean	当前文件是否为LFS文件，true: 是，false: 否
-- isRenamed	boolean	当前文件是否被重命名，true: 是，false: 否
-- sections	array
---- fileName	string	文件名称
---- lines	array
------ leftIdx	string	文件变动之前所在行数
------ rightIdx	string	文件更改后所在行数
------ type	string	文件变更类型，1: 内容未改动，2: 添加， 3: 删除， 4: diff统计信息
------ content	string	文件变更的内容
------ sectionInfo	object
-------- path	string	文件相对仓库的路径
-------- lastLeftIdx	int
-------- lastRightIdx	int
-------- leftHunkSize	int	文件变更之前的行数
-------- rightHunkSize	int	文件变更之后的行数(及当前页面编辑器显示的总行数)
-------- leftIdx	int	文件变更之前所在行数
-------- rightIdx	int	文件变更之后所在行数

返回值

{
  "commits_count": 1,
  "commits": [
    {
      "author": {
        "id": 36480,
        "login": "jasder",
        "name": "段甲生",
        "image_url": "avatars/User/b"
      },
      "committer": {
        "id": 36480,
        "login": "jasder",
        "name": "段甲生",
        "image_url": "avatars/User/b"
      },
      "timestamp": 1604382982,
      "time_from_now": "4小时前",
      "message": "add some file\n* Add the tag list page to the release page\n* Apply suggestions from code review\n* Add the tags list view\n* Add the delete tag way on ui\n* Not delete tag and clear message when delete a release\n",
      "sha": "8f5faee0d3b3be1b8063e84da0c79dd75327b968"
    }
  ],
  "diff": {
    "files_count": 6,
    "total_addition": 447,
    "total_deletion": 0,
    "files": [
      {
        "name": "build.go",
        "old_name": "build.go",
        "index": 1,
        "addition": 33,
        "deletion": 0,
        "type": 1,
        "isCreated": true,
        "isDeleted": false,
        "isBin": false,
        "isLFSFile": false,
        "isRenamed": false,
        "isSubmodule": false,
        "sections": [
          {
            "fileName": "build.go",
            "name": "",
            "lines": [
              {
                "leftIdx": 0,
                "rightIdx": 0,
                "type": 4,
                "content": "@@ -0,0 +1,33 @@",
                "sectionInfo": {
                  "path": "build.go",
                  "lastLeftIdx": 0,
                  "lastRightIdx": 0,
                  "leftIdx": 0,
                  "rightIdx": 1,
                  "leftHunkSize": 0,
                  "rightHunkSize": 33
                }
              },
              {
                "leftIdx": 0,
                "rightIdx": 1,
                "type": 2,
                "content": "+// Copyright 2020 The Gitea Authors. All rights reserved.",
                "sectionInfo": null
              }
            ]
          }
        ]
      }
    ]
  }
}

创建保护分支

POST /api/:owner/:repo/protected_branches

示例

curl -X POST \
-d 'branch_name=master' \
-d 'enable_push=true' \
-d 'enable_push_whitelist=true' \
-d 'enable_push_whitelist=["demo1", "demo1"]' \
-d 'enable_merge_whitelist=true' \
http://localhost:3000/api/trustie/truesite/protected_branches.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者登录名
repo	否	boolean	仓库名称
branch_name	是	string	保护分支名称
enable_push	否	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	否	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	否	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	否	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	否	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	否	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	否	int	所需的批准数，默认为0
enable_approvals_whitelist	否	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	否	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	否	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	否	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	否	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	否	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false

返回参数说明:

参数名	类型	说明
branch_name	string	保护分支名称
enable_push	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	int	所需的批准数，默认为0
enable_approvals_whitelist	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false
created_at	string	创建时间
updated_at	string	更新时间

返回值

{
  "branch_name": "develop",
  "enable_push": true,
  "required_approvals": 0,
  "enable_status_check": true,
  "enable_push_whitelist": true,
  "enable_merge_whitelist": true,
  "enable_approvals_whitelist": false,
  "dismiss_stale_approvals": false,
  "block_on_rejected_reviews": false,
  "block_on_outdated_branch": false,
  "require_signed_commits": false,
  "merge_whitelist_usernames": [
      "jasder"
  ],
  "push_whitelist_usernames": [
      "jasder"
  ],
  "approvals_whitelist_usernames": [],
  "created_at": "2020-12-02 17:40",
  "updated_at": "2020-12-03 11:29"
}

编辑保护分支参数

GET /api/:owner/:repo/protected_branches/:branch_name/edit

示例

curl -X GET \
http://localhost:3000/api/trustie/truesite/protected_branches/master/edit.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者登录名
repo	否	boolean	仓库名称
branch_name	是	string	保护分支名称

返回参数说明:

参数名	类型	说明
protected	boolean	是否为保护分支, true: 是; false: 不是
branch_name	string	保护分支名称
enable_push	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	int	所需的批准数，默认为0
enable_approvals_whitelist	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false
created_at	string	创建时间
updated_at	string	更新时间

返回值

{
  "branch_name": "master",
  "protected": true,
  "protected_branch": {
    "branch_name": "master",
    "enable_push": false,
    "required_approvals": 0,
    "enable_status_check": true,
    "enable_push_whitelist": false,
    "enable_merge_whitelist": true,
    "enable_approvals_whitelist": false,
    "dismiss_stale_approvals": false,
    "block_on_rejected_reviews": false,
    "block_on_outdated_branch": false,
    "require_signed_commits": false,
    "merge_whitelist_usernames": [
        "jasder"
    ],
    "push_whitelist_usernames": [],
    "approvals_whitelist_usernames": [],
    "created_at": "2020-12-03 12:00",
    "updated_at": "2020-12-04 10:50"
  }
}

修改保护分支参数

PATCH /api/:owner/:repo/protected_branches/:branch_name

示例

curl -X PATCH \
-d 'branch_name=master' \
-d 'enable_push=true' \
-d 'enable_push_whitelist=true' \
-d 'enable_push_whitelist=["demo1", "demo1"]' \
-d 'enable_merge_whitelist=true' \
http://localhost:3000/api/trustie/truesite/protected_branches/master.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者登录名
repo	否	boolean	仓库名称
branch_name	是	string	保护分支名称
enable_push	否	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	否	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	否	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	否	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	否	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	否	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	否	int	所需的批准数，默认为0
enable_approvals_whitelist	否	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	否	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	否	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	否	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	否	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	否	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false

返回参数说明:

参数名	类型	说明
branch_name	string	保护分支名称
enable_push	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	int	所需的批准数，默认为0
enable_approvals_whitelist	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false
created_at	string	创建时间
updated_at	string	更新时间

返回值

{
  "branch_name": "develop",
  "enable_push": true,
  "required_approvals": 0,
  "enable_status_check": true,
  "enable_push_whitelist": true,
  "enable_merge_whitelist": true,
  "enable_approvals_whitelist": false,
  "dismiss_stale_approvals": false,
  "block_on_rejected_reviews": false,
  "block_on_outdated_branch": false,
  "require_signed_commits": false,
  "merge_whitelist_usernames": [
      "jasder"
  ],
  "push_whitelist_usernames": [
      "jasder"
  ],
  "approvals_whitelist_usernames": [],
  "created_at": "2020-12-02 17:40",
  "updated_at": "2020-12-03 11:29"
}

删除保护分支

DELETE /api/:owner/:repo/protected_branches/:branch_name

示例

curl -X DELETE \
http://localhost:3000/api/trustie/truesite/protected_branches/master.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者登录名
repo	否	boolean	仓库名称
branch_name	是	string	保护分支名称

返回参数说明:

参数名	类型	说明
status	int	状态值，0: 请求成功; -1: 请求失败
message	string	信息说明

返回值

{
  "status": 0,
  "message": "success"
}

获取保护分支列表

GET /api/:owner/:repo/protected_branches/

示例

curl -X GET \
-d "page=1" \
-d "limit=5" \
http://localhost:3000/api/trustie/truesite/protected_branches.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者登录名
repo	否	boolean	仓库名称
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认15条

返回参数说明:

参数名	类型	说明
total_count	int	总记录数
branch_name	string	保护分支名称
enable_push	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	int	所需的批准数，默认为0
enable_approvals_whitelist	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false
created_at	string	创建时间
updated_at	string	更新时间

返回值

{
  "total_count": 1,
  "protected_branches": [
    {
      "branch_name": "develop",
      "enable_push": true,
      "required_approvals": 0,
      "enable_status_check": true,
      "enable_push_whitelist": true,
      "enable_merge_whitelist": true,
      "enable_approvals_whitelist": false,
      "dismiss_stale_approvals": false,
      "block_on_rejected_reviews": false,
      "block_on_outdated_branch": false,
      "require_signed_commits": false,
      "merge_whitelist_usernames": [
          "jasder"
      ],
      "push_whitelist_usernames": [
          "jasder"
      ],
      "approvals_whitelist_usernames": [],
      "created_at": "2020-12-02 17:40",
      "updated_at": "2020-12-03 11:29"
    }
  ]
}

获取某个具体的保护分支

GET /api/:owner/:repo/protected_branches/:branch_name

示例

curl -X GET \
http://localhost:3000/api/trustie/truesite/protected_branches/master.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者登录名
repo	否	boolean	仓库名称
branch_name	是	string	保护分支名称

返回参数说明:

参数名	类型	说明
branch_name	string	保护分支名称
enable_push	boolean	是否启用推送, true: 启用; false: 不启用, 默认为false
enable_push_whitelist	boolean	是否启用白名单推送, true: 启用; false: 不启用, 默认为false, 该参数与enable_push参数为单选项，只能选择
push_whitelist_usernames	array	推送白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_push_whitelist参数配合使用
enable_merge_whitelist	boolean	是否启用合并白名单, true: 启用, false: 不启用, 默认为false
merge_whitelist_usernames	array	合并白名单用户(即具有写操作的项目成员名称的数组), 该参数与enable_merge_whitelist配合使用
enable_status_check	boolean	是否启用状态检查, true: 启用; false: 不启用, 默认为false
required_approvals	int	所需的批准数，默认为0
enable_approvals_whitelist	boolean	是否启用批准仅限列入白名单的用户或团队, true: 启用, false: 不启用, 默认为false
approvals_whitelist_usernames	array	审查者白名单(即具有写操作的项目成员名称的数组), 该参数与enable_approvals_whitelist配合使用
block_on_rejected_reviews	boolean	是否启用拒绝审核阻止合并功能, true: 启用, false: 不启用, 默认为false
dismiss_stale_approvals	boolean	是否启用取消过时的批准, true: 启用, false: 不启用, 默认为false
require_signed_commits	boolean	是否需要签名提交, true: 是, false: 否, 默认为false
block_on_outdated_branch	boolean	如果拉取请求已经过时，是否阻止合并, true: 是, false: 否, 默认为false
created_at	string	创建时间
updated_at	string	更新时间

返回值

{
  "branch_name": "develop",
  "enable_push": true,
  "required_approvals": 0,
  "enable_status_check": true,
  "enable_push_whitelist": true,
  "enable_merge_whitelist": true,
  "enable_approvals_whitelist": false,
  "dismiss_stale_approvals": false,
  "block_on_rejected_reviews": false,
  "block_on_outdated_branch": false,
  "require_signed_commits": false,
  "merge_whitelist_usernames": [
      "jasder"
  ],
  "push_whitelist_usernames": [
      "jasder"
  ],
  "approvals_whitelist_usernames": [],
  "created_at": "2020-12-02 17:40",
  "updated_at": "2020-12-03 11:29"
}

DevOps相关api

获取devops流程步骤

GET  /api/:owner/:repo/ci_authorize

示例

curl -X GET \
http://localhost:3000/api/jasder/forgeplus/ci_authorize.json  | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier

返回参数说明:

参数名	类型	说明
step	int	初始化devops流程步骤; 0: 标识未开启devops，1: 标识用户已填写了云服务器相关信息，但并未开启认证， 2: 标识用户已开启了CI服务端的认证
account	string	你的云服务器帐号
ip	string	你的云服务器帐号ip
secret	string	你的云服务器登录密码
authenticate_url	string	devops授权认证地址，只有填写了服务器相关信息后才会有该地址
get_drone_token_url	string	获取CI服务端token地址, 只有认证成功后才会有该地址

返回值

{
  "step": 0,
  "cloud_account": {
    "id": 1,
    "account": "xxx",
    "ip": "xxx.xxx.xxx.x",
    "secret": "11111",
    "authenticate_url": "http://localhost:3000/login",
    "get_drone_token_url": "http://localhost:3000/account"
  }
}

初始化DevOps流程

POST  /api/:owner/:repo/cloud_accounts

示例

curl -X POST \
-d "account=xx" \
-d "secret=xxx" \
-d "ip_num=xx.xx.xx.xx" \
https://localhost:3000/api/jasder/forgeplus/cloud_accounts.json  | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier
account	是	string	云服务器ssh连接登录用户名
secret	是	string	云服务器ssh连接登录秘密
ip_num	否	string	云服务器公网IP

返回参数说明:

参数名	类型	说明
status	string	服务端返回状态，0: 表示请求成功， -1: 标识请求失败
message	string	服务端返回信息说明
redirect_url	string	重定向地址，请求成功后，需要调整到该地址进行认证

返回值

{
  "status": 0,
  "message": "success",
  "redirect_url": "http://192.168.2.59:3003/login/oauth/authorize?client_id=f0c58484-d0f7-46c0-9efd-de3e3218e723&redirect_uri=http://121.36.81.172:80/login&response_type=code"
}

devops用户认证授权

GET /api/users/ci/oauth_grant

示例

curl -X GET \
-d "password=123456" \
http://localhost:3000/api/users/ci/oauth_grant.json | jq

请求参数说明:

参数名	必选	类型	说明
password	是	string	用户密码

返回参数说明:

参数名	类型	说明
status	int	0:成功， -1: 失败

返回值

{
  "status": 0,
  "message": "success"
}

激活项目

POST /api/:owner/:repo/activate

示例

curl -X POST \
http://localhost:3000/api/jasder/forgeplus/activate.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier

返回参数说明:

参数名	类型	说明
status	int	0:成功， -1: 失败

返回值

{
  "status": 0,
  "message": "success"
}

取消激活项目

DELETE /api/:owner/:repo/deactivate

示例

curl -X POST \
http://localhost:3000/api/jasder/forgeplus/deactivate.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier

返回参数说明:

参数名	类型	说明
status	int	0:成功， -1: 失败

返回值

{
  "status": 0,
  "message": "success"
}

获取仓库的.trustie-pipeline.yml

GET /api/:owner/:repo/get_trustie_pipeline

示例

curl -X GET \
http://localhost:3000/api/jasder/forge/get_trustie_pipeline.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier
ref	否	string	分支名称、tag名称或是提交记录id，默认为master分支

返回参数说明:

参数名	类型	说明
name	string	文件夹或文件名称
path	string	文件夹或文件相对路径
content	string	文件内容，

返回值

{
  "name": ".trustie-pipeline.yml",
  "path": ".trustie-pipeline.yml",
  "sha": "548sfefsafef48sf485s4f",
  "content": "..jsaf"
}

更新'.trustie-pipeline.yml'文件

PUT /api/:owner/:repo/update_trustie_pipeline

示例

curl -X GET \
http://localhost:3000/api/jasder/forge/update_trustie_pipeline.json | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	用户登录名
repo	是	string	project's identifier
ref	否	string	分支名称、tag名称或是提交记录id，默认为master分支
filepath	是	string	文件相对于仓库的路径(或修改后的文件路径)
from_path	是	string	原文件相对于仓库的路径, 只有当需要修改原文件名称时，才需要该参数
sha	是	string	文件的sha标识值
content	是	string	内容
message	否	string	提交说明
branch	否	string	分支名称, branch和new_branch必须存在一个,且只能存在一个
new_branch	否	string	新的分支名称
ci_language_id	否	string	新的分支名称

返回参数说明:

参数名	类型	说明
status	int	接口返回状态， 1: 请求成功， -1: 请求失败
message	string	文件夹或文件相对路径

{
  "status": 1,
  "message": ".trustie-pipeline.yml"
}

获取语言列表

GET  /api/ci/languages

示例

curl -X GET http://localhost:3000/api/ci/languages.json | jq

返回参数说明:

参数名	类型	说明
id	int	id值
name	string	语言名称
content	string	语言内容
cover_url	string	语言的logo链接

返回值

[
  {
    "id": 114,
    "name": "C",
    "cover_url": null,
    "content": "kind: pipeline\n          name: default\n\n          platform:\n            os: linux\n            arch: arm64\n\n          steps:\n          - name: test\n           image: gcc\n           commands:\n           - ./configure\n           - make\n           - make test",
  }
]

获取常用的6大语言

GET  /api/ci/languages/common

示例

curl -X GET http://localhost:3000/api/ci/languages/common.json | jq

返回参数说明:

参数名	类型	说明
id	int	id值
name	string	语言名称
content	string	语言内容
cover_url	string	语言的logo链接

返回值

[
  {
    "id": 114,
    "name": "C",
    "cover_url": null,
    "content": "kind: pipeline\n          name: default\n\n          platform:\n            os: linux\n            arch: arm64\n\n          steps:\n          - name: test\n           image: gcc\n           commands:\n           - ./configure\n           - make\n           - make test",
  }
]

获取语言详情

GET  /api/ci/languages/:id

示例

curl -X GET http://localhost:3000/api/ci/languages/114.json | jq

请求参数说明:

参数名	必选	类型	说明
id	是	int	language's id

返回参数说明:

参数名	类型	说明
id	int	id值
name	string	语言名称
content	string	语言内容
cover_url	string	语言的logo链接

返回值

[
  {
    "id": 114,
    "name": "C",
    "cover_url": null,
    "content": "kind: pipeline\n          name: default\n\n          platform:\n            os: linux\n            arch: arm64\n\n          steps:\n          - name: test\n           image: gcc\n           commands:\n           - ./configure\n           - make\n           - make test",
  }
]

获取构建列表

GET  /api/:owner/:repo/builds

示例

curl -X GET \
http://localhost:3000/api/Jason/forge/builds | jq

请求参数说明:

参数名	必选	类型	说明
owner	是	string	项目拥有者
repo	是	string	项目identifier
page	否	string	页数，第几页
limit	否	string	每页多少条数据，默认20条
search	是	string	构建状态条件过滤; 值说明：pending: 准备中，failure: 构建失败，running: 运行中，error：构建失败(.trustie-pipeline.yml文件错误)，success: 构建成功，killed: 撤销构建

返回参数说明:

参数名	类型	说明
id	int	build's id
number	string	build's number
status	string	build's result
event	string	build's event

返回值

[
  {
    "id": 1,
    "repo_id": 8,
    "trigger": "@hook",
    "number": 1,
    "status": "success",
    "event": "push",
    "action": "",
    "link": "",
    "timestamp": 0,
    "message": "更新 '.trustie-pipeline.yml'\n",
    "before": "5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324",
    "after": "5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
    "ref": "refs/heads/master",
    "source_repo": "",
    "source": "master",
    "target": "master",
    "author_login": "jasder",
    "author_name": "jasder",
    "author_email": "email.com",
    "author_avatar": "",
    "sender": "jasder",
    "started": "2020-08-19 06:22",
    "finished": "2020-08-19 06:22",
    "created": "2020-08-19 06:22",
    "updated": "2020-08-19 06:22",
    "duration_time": 0,
    "version": 3
  }
]

获取某条构建详情信息

GET  /api/:owner/:repo/builds/:build

示例

curl -X GET \
http://ocalhost:3000/api/jasder/forge/builds/1 | jq

请求参数说明:

参数名	必选	类型	说明
build	是	int	build's number

返回参数说明:

参数名	类型	说明
id	int	build's id
status	string	build's status
event	string	build's event

返回值

{
  "id": 1,
  "repo_id": 8,
  "trigger": "@hook",
  "number": 1,
  "status": "success",
  "event": "push",
  "action": "",
  "link": "http://localhost:3000/jasder/forgeplus/compare/5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324...5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
  "timestamp": 0,
  "message": "更新 '.trustie-pipeline.yml'\n",
  "before": "5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324",
  "after": "5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
  "ref": "refs/heads/master",
  "source_repo": "",
  "source": "master",
  "target": "master",
  "author_login": "jasder",
  "author_name": "jasder",
  "author_email": "2053003901@qq.com",
  "author_avatar": "http://localhost:3000/user/avatar/jasder/-1",
  "sender": "jasder",
  "started": 1595317786,
  "finished": 1595318426,
  "created": 1595317786,
  "updated": 1595317786,
  "version": 3,
  "stages": [
    {
      "id": 1,
      "repo_id": 8,
      "build_id": 1,
      "number": 1,
      "name": "default",
      "kind": "pipeline",
      "type": "docker",
      "status": "success",
      "errignore": false,
      "exit_code": 0,
      "machine": "121.36.81.172",
      "os": "linux",
      "arch": "arm64",
      "started": 1595317786,
      "stopped": 1595318426,
      "created": 1595317786,
      "updated": 1595318426,
      "version": 4,
      "on_success": true,
      "on_failure": false,
      "steps": [
        {
          "id": 1,
          "step_id": 1,
          "number": 1,
          "name": "clone",
          "status": "success",
          "exit_code": 0,
          "started": 1595317786,
          "stopped": 1595318373,
          "version": 4
        },
        {
          "id": 2,
          "step_id": 1,
          "number": 2,
          "name": "test",
          "status": "success",
          "exit_code": 0,
          "started": 1595318373,
          "stopped": 1595318426,
          "version": 4
        }
      ]
    }
  ]
}

重启构建/重新构建

POST  /api/:owner/:repo/builds/:build/restart

示例

curl -X POST \
http://localhost:3000/api/jasder/forgeplus/builds/1 | jq

请求参数说明:

参数名	必选	类型	说明
build	是	int	build's number

返回参数说明:

参数名	类型	说明
id	int	build's id
status	string	build's status
event	string	build's event

返回值

{
  "id": 2,
  "repo_id": 8,
  "trigger": "jasder",
  "number": 2,
  "status": "pending",
  "event": "push",
  "action": "",
  "link": "http://localhost:3000/jasder/forgeplus/compare/5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324...5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
  "timestamp": 0,
  "message": "更新 '.trustie-pipeline.yml'\n",
  "before": "5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324",
  "after": "5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
  "ref": "refs/heads/master",
  "source_repo": "",
  "source": "master",
  "target": "master",
  "author_login": "jasder",
  "author_name": "jasder",
  "author_email": "2053003901@qq.com",
  "author_avatar": "http://localhost:3000/user/avatar/jasder/-1",
  "sender": "jasder",
  "started": 0,
  "finished": 0,
  "created": 1595321350,
  "updated": 1595321350,
  "version": 1
}

关闭构建

DELETE  /api/:owner/:repo/builds/:build/stop

示例

curl -X DELETE \
http://localhost:3000/api/jaser/forge/builds/2 | jq

请求参数说明:

参数名	必选	类型	说明
build	是	int	build's number

返回参数说明:

参数名	类型	说明
id	int	build's id
status	string	build's status
event	string	build's event

返回值

{
  "id": 2,
  "repo_id": 8,
  "trigger": "jasder",
  "number": 2,
  "status": "killed",
  "event": "push",
  "action": "",
  "link": "http://localhost:3000/jasder/forgeplus/compare/5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324...5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
  "timestamp": 0,
  "message": "更新 '.trustie-pipeline.yml'\n",
  "before": "5e7c6f7dfd5ce6cc6e287fcbc000dadd9992b324",
  "after": "5e52ce51a239f5c8dd0b489a8a71e94f976179b4",
  "ref": "refs/heads/master",
  "source_repo": "",
  "source": "master",
  "target": "master",
  "author_login": "jasder",
  "author_name": "jasder",
  "author_email": "2053003901@qq.com",
  "author_avatar": "http://localhost:3000/user/avatar/jasder/-1",
  "sender": "jasder",
  "started": 1595321352,
  "finished": 1595321590,
  "created": 1595321350,
  "updated": 1595321352,
  "version": 3,
  "stages": [
    {
      "id": 2,
      "repo_id": 8,
      "build_id": 2,
      "number": 1,
      "name": "default",
      "kind": "pipeline",
      "type": "docker",
      "status": "killed",
      "errignore": false,
      "exit_code": 0,
      "machine": "121.36.81.172",
      "os": "linux",
      "arch": "arm64",
      "started": 1595321352,
      "stopped": 1595321590,
      "created": 1595321350,
      "updated": 1595321352,
      "version": 4,
      "on_success": true,
      "on_failure": false,
      "steps": [
        {
          "id": 3,
          "step_id": 2,
          "number": 1,
          "name": "clone",
          "status": "killed",
          "exit_code": 130,
          "started": 1595321353,
          "stopped": 1595321590,
          "version": 3
        },
        {
          "id": 4,
          "step_id": 2,
          "number": 2,
          "name": "test",
          "status": "skipped",
          "exit_code": 130,
          "started": 1595321590,
          "stopped": 1595321590,
          "version": 2
        }
      ]
    }
  ]
}

获取某条构建的log信息

GET  /api/:owner/:repo/builds/:build/logs/:stage/:step

示例

curl -X GET \
http://localhost:3000/api/dev_ops/builds/2/logs/1/1 | jq

请求参数说明:

参数名	必选	类型	说明
build	是	int	build's number
stage	是	int	build's stage number
step	是	int	build's step number

返回参数说明:

参数名	类型	说明
id	int	build's id
status	string	build's status
event	string	build's event

返回值

[
  {
    "pos": 0,
    "out": "+ git fetch origin +refs/heads/master:\n",
    "time": 1
  },
  {
    "pos": 1,
    "out": "Initialized empty Git repository in /drone/src/.git/\n",
    "time": 1
  },
  {
    "pos": 2,
    "out": "warning: redirecting to https://testgitea2.trustie.net/jasder/forgeplus.git/\n",
    "time": 1
  },
  {
    "pos": 3,
    "out": "From http://testgitea2.trustie.net/jasder/forgeplus\n",
    "time": 493
  },
  {
    "pos": 4,
    "out": " * branch            master     -> FETCH_HEAD\n",
    "time": 493
  },
  {
    "pos": 5,
    "out": " * [new branch]      master     -> origin/master\n",
    "time": 493
  },
  {
    "pos": 6,
    "out": "+ git checkout 5e52ce51a239f5c8dd0b489a8a71e94f976179b4 -b master\n",
    "time": 493
  },
  {
    "pos": 7,
    "out": "Already on 'master'\n",
    "time": 496
  }
]

获取CI服务器配置信息

GET  /api/users/ci/cloud_account

示例

curl -X GET \
http://localhost:3000/api/users/ci/cloud_account | jq

返回参数说明:

参数名	类型	说明
step	int	0: 未绑定；1: 未认证(已绑定)
ci_certification	boolean	true: 已认证， false: 未认证
ip	string	ci服务器ip
redirect_url	string	认证地址

返回值

{
  "step": 0,
  "ci_certification": false,
  "cloud_account": {
    "ip": "xxx.xxx.xxx.x",
    "redirect_url": "http://localhost:3000/login",
  }
}

绑定CI服务器

POST  /api/users/ci/cloud_account/bind

示例

curl -X POST \
-d "account=xx" \
-d "secret=xxx" \
-d "ip_num=xx.xx.xx.xx" \
https://localhost:3000/api/users/ci/cloud_account/bind.json  | jq

请求参数说明:

参数名	必选	类型	说明
account	是	string	云服务器ssh连接登录用户名
secret	是	string	云服务器ssh连接登录秘密
ip_num	否	string	云服务器公网IP

返回参数说明:

参数名	类型	说明
step	int	0: 未绑定；1: 未认证(已绑定)，2: 已认证
ip	string	ci服务器ip
redirect_url	string	认证地址

返回值

{
  "step": 0,
  "cloud_account": {
    "ip": "xxx.xxx.xxx.x",
    "redirect_url": "http://localhost:3000/login",
  }
}

解除CI服务器绑定

DELETE  /api/users/ci/cloud_account/unbind

示例

curl -X DELETE \
http://localhost:3000/api/users/ci/cloud_account/unbind.json | jq

返回参数说明:

参数名	类型	说明
status	int	状态码， 0: 成功，-1: 失败
message	string	返回信息说明

返回值

{
  "status": 0,
  "message": "success"
}

项目列表

GET  /api/users/:login/projects

示例

curl -X GET \
-d "page=1" \
-d "limit=20" \
http://localhost:3000/api/users/Jason/projects.json | jq

请求参数说明:

参数名	必选	类型	说明
page	否	int	页数，第几页
limit	否	int	每页多少条数据，默认20条

返回参数说明:

参数名	类型	说明
total_count	int	项目总条数
id	string	项目id
name	string	项目名称
description	string	项目简介
open_devops	boolean	激活状态，true: 激活； false：未激活
visits	int	流量数
forked_count	int	被fork的数量
praises_count	int	star数量
is_public	boolean	是否公开， true:公开，false:未公开
mirror_url	string	镜像url
last_update_time	int	最后更新时间，为UNIX格式的时间戳
author	object	项目创建者
-- name	string	用户名，也是用户标识
category	object	项目类别
-- id	int	项目类型id
-- name	string	项目类型名称
language	object	项目语言
-- id	int	项目语言id
-- name	string	项目语言名称

返回值

{
  "total_count": 3096,
  "projects": [
    {
      "id": 1,
      "name": "hnfl_demo1",
      "description": "my first project",
      "visits": 0,
      "praises_count": 0,
      "forked_count": 0,
      "is_public": true,
      "mirror_url": null,
      "last_update_time": 1577697461,
      "author": {
        "name": "18816895620",
        "image_url": "avatars/User/b"
      },
      "category": {
        "id": 1,
        "name": "大数据"
      },
      "language": {
        "id": 2,
        "name": "C"
      }
    }
  ]
}

101 KiB Raw Blame History Unescape Escape

用户注册(通过其他平台)

获取当前登录用户信息

用户列表(带搜索功能)

获取项目类别列表(可根据名称搜素)

获取项目语言列表(可根据名称搜素)

获取.gitignore模板列表(可根据名称搜素)

获取开源许可证列表(可根据名称搜素)

创建项目

新建镜像项目

手动同步镜像

项目详情

项目详情(简版)

编辑仓库信息

修改项目信息

删除项目

项目添加成员

项目删除成员

更改项目成员角色/权限

项目成员列表

Fork项目

获取代码目录列表

获取子目录代码列表/编辑某个具体的文件

项目类别列表(用于项目列表左侧导航中的项目类别列表)

项目类型列表(用于项目列表左侧导航上方中的项目类型列表)

项目列表

推荐项目

项目主页

修改项目主页内容

获取分支列表

获取代码库标签列表

仓库详情

获取提交记录列表

获取某个提交记录(包含diff)

点赞

取消点赞

用户是否点过赞

项目的点赞者列表

关注(项目)

取消关注

用户是否关注过项目

项目的关注者列表

仓库新建文件

更新仓库中的文件

删除仓库中的文件

获取pull request文件列表

获取pull request的commits列表

compare two commits

创建保护分支

编辑保护分支参数

修改保护分支参数

删除保护分支

获取保护分支列表

获取某个具体的保护分支

DevOps相关api

获取devops流程步骤

初始化DevOps流程

devops用户认证授权

激活项目

取消激活项目

获取仓库的.trustie-pipeline.yml

更新'.trustie-pipeline.yml'文件

获取语言列表

获取常用的6大语言

获取语言详情

获取构建列表

获取某条构建详情信息

重启构建/重新构建

关闭构建

获取某条构建的log信息

获取CI服务器配置信息

绑定CI服务器

解除CI服务器绑定

项目列表

101 KiB

Raw Blame History