2015-12-04 22:16:42 +00:00
|
|
|
// Copyright 2015 The Gogs Authors. All rights reserved.
|
|
|
|
// Use of this source code is governed by a MIT-style
|
|
|
|
// license that can be found in the LICENSE file.
|
|
|
|
|
2017-05-02 13:35:59 +00:00
|
|
|
// Package v1 Gitea API.
|
|
|
|
//
|
2017-11-13 07:02:25 +00:00
|
|
|
// This documentation describes the Gitea API.
|
2017-05-02 13:35:59 +00:00
|
|
|
//
|
|
|
|
// Schemes: http, https
|
|
|
|
// BasePath: /api/v1
|
|
|
|
// Version: 1.1.1
|
|
|
|
// License: MIT http://opensource.org/licenses/MIT
|
|
|
|
//
|
|
|
|
// Consumes:
|
|
|
|
// - application/json
|
|
|
|
// - text/plain
|
|
|
|
//
|
|
|
|
// Produces:
|
|
|
|
// - application/json
|
|
|
|
// - text/html
|
|
|
|
//
|
2017-08-21 11:13:47 +00:00
|
|
|
// Security:
|
|
|
|
// - BasicAuth: []
|
|
|
|
// - Token: []
|
|
|
|
// - AccessToken: []
|
|
|
|
// - AuthorizationHeaderToken: []
|
|
|
|
//
|
|
|
|
// SecurityDefinitions:
|
|
|
|
// BasicAuth:
|
|
|
|
// type: basic
|
|
|
|
// Token:
|
|
|
|
// type: apiKey
|
|
|
|
// name: token
|
|
|
|
// in: query
|
|
|
|
// AccessToken:
|
|
|
|
// type: apiKey
|
|
|
|
// name: access_token
|
|
|
|
// in: query
|
|
|
|
// AuthorizationHeaderToken:
|
|
|
|
// type: apiKey
|
|
|
|
// name: Authorization
|
|
|
|
// in: header
|
|
|
|
//
|
2017-05-02 13:35:59 +00:00
|
|
|
// swagger:meta
|
2015-12-04 22:16:42 +00:00
|
|
|
package v1
|
|
|
|
|
|
|
|
import (
|
|
|
|
"strings"
|
|
|
|
|
2016-11-10 16:24:48 +00:00
|
|
|
"code.gitea.io/gitea/models"
|
|
|
|
"code.gitea.io/gitea/modules/auth"
|
|
|
|
"code.gitea.io/gitea/modules/context"
|
2018-02-14 04:46:00 +00:00
|
|
|
"code.gitea.io/gitea/modules/setting"
|
2016-11-10 16:24:48 +00:00
|
|
|
"code.gitea.io/gitea/routers/api/v1/admin"
|
|
|
|
"code.gitea.io/gitea/routers/api/v1/misc"
|
|
|
|
"code.gitea.io/gitea/routers/api/v1/org"
|
|
|
|
"code.gitea.io/gitea/routers/api/v1/repo"
|
2017-11-13 07:02:25 +00:00
|
|
|
_ "code.gitea.io/gitea/routers/api/v1/swagger" // for swagger generation
|
2016-11-10 16:24:48 +00:00
|
|
|
"code.gitea.io/gitea/routers/api/v1/user"
|
2017-07-12 01:23:41 +00:00
|
|
|
"code.gitea.io/gitea/routers/api/v1/utils"
|
2017-11-13 07:02:25 +00:00
|
|
|
api "code.gitea.io/sdk/gitea"
|
|
|
|
|
|
|
|
"github.com/go-macaron/binding"
|
|
|
|
"gopkg.in/macaron.v1"
|
2015-12-04 22:16:42 +00:00
|
|
|
)
|
|
|
|
|
2016-08-05 00:08:01 +00:00
|
|
|
func repoAssignment() macaron.Handler {
|
2016-03-13 22:49:16 +00:00
|
|
|
return func(ctx *context.APIContext) {
|
2015-12-04 22:16:42 +00:00
|
|
|
userName := ctx.Params(":username")
|
|
|
|
repoName := ctx.Params(":reponame")
|
|
|
|
|
|
|
|
var (
|
|
|
|
owner *models.User
|
|
|
|
err error
|
|
|
|
)
|
|
|
|
|
|
|
|
// Check if the user is the same as the repository owner.
|
|
|
|
if ctx.IsSigned && ctx.User.LowerName == strings.ToLower(userName) {
|
|
|
|
owner = ctx.User
|
|
|
|
} else {
|
|
|
|
owner, err = models.GetUserByName(userName)
|
|
|
|
if err != nil {
|
|
|
|
if models.IsErrUserNotExist(err) {
|
2016-03-13 22:49:16 +00:00
|
|
|
ctx.Status(404)
|
2015-12-04 22:16:42 +00:00
|
|
|
} else {
|
2016-03-13 22:49:16 +00:00
|
|
|
ctx.Error(500, "GetUserByName", err)
|
2015-12-04 22:16:42 +00:00
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
ctx.Repo.Owner = owner
|
|
|
|
|
|
|
|
// Get repository.
|
2016-07-23 17:08:22 +00:00
|
|
|
repo, err := models.GetRepositoryByName(owner.ID, repoName)
|
2015-12-04 22:16:42 +00:00
|
|
|
if err != nil {
|
|
|
|
if models.IsErrRepoNotExist(err) {
|
2017-02-05 14:35:03 +00:00
|
|
|
redirectRepoID, err := models.LookupRepoRedirect(owner.ID, repoName)
|
|
|
|
if err == nil {
|
|
|
|
context.RedirectToRepo(ctx.Context, redirectRepoID)
|
|
|
|
} else if models.IsErrRepoRedirectNotExist(err) {
|
|
|
|
ctx.Status(404)
|
|
|
|
} else {
|
|
|
|
ctx.Error(500, "LookupRepoRedirect", err)
|
|
|
|
}
|
2015-12-04 22:16:42 +00:00
|
|
|
} else {
|
2016-03-13 22:49:16 +00:00
|
|
|
ctx.Error(500, "GetRepositoryByName", err)
|
2015-12-04 22:16:42 +00:00
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
2017-02-02 12:33:56 +00:00
|
|
|
repo.Owner = owner
|
2015-12-04 22:16:42 +00:00
|
|
|
|
2016-03-14 03:20:22 +00:00
|
|
|
if ctx.IsSigned && ctx.User.IsAdmin {
|
2016-11-07 16:20:37 +00:00
|
|
|
ctx.Repo.AccessMode = models.AccessModeOwner
|
2016-03-14 03:20:22 +00:00
|
|
|
} else {
|
2017-07-12 01:23:41 +00:00
|
|
|
mode, err := models.AccessLevel(utils.UserID(ctx), repo)
|
2016-03-14 03:20:22 +00:00
|
|
|
if err != nil {
|
|
|
|
ctx.Error(500, "AccessLevel", err)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
ctx.Repo.AccessMode = mode
|
2015-12-04 22:16:42 +00:00
|
|
|
}
|
|
|
|
|
2016-03-14 03:20:22 +00:00
|
|
|
if !ctx.Repo.HasAccess() {
|
2016-03-13 22:49:16 +00:00
|
|
|
ctx.Status(404)
|
2015-12-04 22:16:42 +00:00
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
ctx.Repo.Repository = repo
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Contexter middleware already checks token for user sign in process.
|
2016-08-05 00:08:01 +00:00
|
|
|
func reqToken() macaron.Handler {
|
2016-03-11 16:56:52 +00:00
|
|
|
return func(ctx *context.Context) {
|
2015-12-04 22:16:42 +00:00
|
|
|
if !ctx.IsSigned {
|
|
|
|
ctx.Error(401)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-05 00:08:01 +00:00
|
|
|
func reqBasicAuth() macaron.Handler {
|
2016-03-11 16:56:52 +00:00
|
|
|
return func(ctx *context.Context) {
|
2015-12-04 22:16:42 +00:00
|
|
|
if !ctx.IsBasicAuth {
|
|
|
|
ctx.Error(401)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-05 00:08:01 +00:00
|
|
|
func reqAdmin() macaron.Handler {
|
2016-03-11 16:56:52 +00:00
|
|
|
return func(ctx *context.Context) {
|
2016-07-23 09:56:37 +00:00
|
|
|
if !ctx.IsSigned || !ctx.User.IsAdmin {
|
2015-12-04 22:16:42 +00:00
|
|
|
ctx.Error(403)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-24 23:05:56 +00:00
|
|
|
func reqRepoWriter() macaron.Handler {
|
|
|
|
return func(ctx *context.Context) {
|
|
|
|
if !ctx.Repo.IsWriter() {
|
|
|
|
ctx.Error(403)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-01-14 02:14:48 +00:00
|
|
|
func reqOrgMembership() macaron.Handler {
|
|
|
|
return func(ctx *context.APIContext) {
|
|
|
|
var orgID int64
|
|
|
|
if ctx.Org.Organization != nil {
|
|
|
|
orgID = ctx.Org.Organization.ID
|
|
|
|
} else if ctx.Org.Team != nil {
|
|
|
|
orgID = ctx.Org.Team.OrgID
|
|
|
|
} else {
|
|
|
|
ctx.Error(500, "", "reqOrgMembership: unprepared context")
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2017-12-21 07:43:26 +00:00
|
|
|
if isMember, err := models.IsOrganizationMember(orgID, ctx.User.ID); err != nil {
|
|
|
|
ctx.Error(500, "IsOrganizationMember", err)
|
|
|
|
return
|
|
|
|
} else if !isMember {
|
2017-01-26 11:54:04 +00:00
|
|
|
if ctx.Org.Organization != nil {
|
|
|
|
ctx.Error(403, "", "Must be an organization member")
|
|
|
|
} else {
|
|
|
|
ctx.Status(404)
|
|
|
|
}
|
2017-01-14 02:14:48 +00:00
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
func reqOrgOwnership() macaron.Handler {
|
|
|
|
return func(ctx *context.APIContext) {
|
|
|
|
var orgID int64
|
|
|
|
if ctx.Org.Organization != nil {
|
|
|
|
orgID = ctx.Org.Organization.ID
|
|
|
|
} else if ctx.Org.Team != nil {
|
|
|
|
orgID = ctx.Org.Team.OrgID
|
|
|
|
} else {
|
|
|
|
ctx.Error(500, "", "reqOrgOwnership: unprepared context")
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2017-12-21 07:43:26 +00:00
|
|
|
isOwner, err := models.IsOrganizationOwner(orgID, ctx.User.ID)
|
|
|
|
if err != nil {
|
|
|
|
ctx.Error(500, "IsOrganizationOwner", err)
|
|
|
|
} else if !isOwner {
|
2017-01-26 11:54:04 +00:00
|
|
|
if ctx.Org.Organization != nil {
|
|
|
|
ctx.Error(403, "", "Must be an organization owner")
|
|
|
|
} else {
|
|
|
|
ctx.Status(404)
|
|
|
|
}
|
2017-01-14 02:14:48 +00:00
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-05 00:08:01 +00:00
|
|
|
func orgAssignment(args ...bool) macaron.Handler {
|
2016-03-25 22:04:02 +00:00
|
|
|
var (
|
2016-04-04 23:41:34 +00:00
|
|
|
assignOrg bool
|
2016-03-25 22:04:02 +00:00
|
|
|
assignTeam bool
|
|
|
|
)
|
|
|
|
if len(args) > 0 {
|
2016-04-04 23:41:34 +00:00
|
|
|
assignOrg = args[0]
|
|
|
|
}
|
|
|
|
if len(args) > 1 {
|
|
|
|
assignTeam = args[1]
|
2016-03-25 22:04:02 +00:00
|
|
|
}
|
|
|
|
return func(ctx *context.APIContext) {
|
2016-04-04 23:41:34 +00:00
|
|
|
ctx.Org = new(context.APIOrganization)
|
|
|
|
|
|
|
|
var err error
|
|
|
|
if assignOrg {
|
2017-07-06 13:30:19 +00:00
|
|
|
ctx.Org.Organization, err = models.GetOrgByName(ctx.Params(":orgname"))
|
2016-04-04 23:41:34 +00:00
|
|
|
if err != nil {
|
2017-07-06 13:30:19 +00:00
|
|
|
if models.IsErrOrgNotExist(err) {
|
2016-04-04 23:41:34 +00:00
|
|
|
ctx.Status(404)
|
|
|
|
} else {
|
2017-07-06 13:30:19 +00:00
|
|
|
ctx.Error(500, "GetOrgByName", err)
|
2016-04-04 23:41:34 +00:00
|
|
|
}
|
|
|
|
return
|
2016-03-25 22:04:02 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if assignTeam {
|
|
|
|
ctx.Org.Team, err = models.GetTeamByID(ctx.ParamsInt64(":teamid"))
|
|
|
|
if err != nil {
|
|
|
|
if models.IsErrUserNotExist(err) {
|
|
|
|
ctx.Status(404)
|
|
|
|
} else {
|
|
|
|
ctx.Error(500, "GetTeamById", err)
|
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-08-05 00:08:01 +00:00
|
|
|
func mustEnableIssues(ctx *context.APIContext) {
|
2017-08-02 08:46:54 +00:00
|
|
|
if !ctx.Repo.Repository.UnitEnabled(models.UnitTypeIssues) {
|
2016-08-04 23:32:02 +00:00
|
|
|
ctx.Status(404)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-12-02 11:10:39 +00:00
|
|
|
func mustAllowPulls(ctx *context.Context) {
|
|
|
|
if !ctx.Repo.Repository.AllowsPulls() {
|
|
|
|
ctx.Status(404)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-12-04 22:16:42 +00:00
|
|
|
// RegisterRoutes registers all v1 APIs routes to web application.
|
|
|
|
// FIXME: custom form error response
|
|
|
|
func RegisterRoutes(m *macaron.Macaron) {
|
|
|
|
bind := binding.Bind
|
|
|
|
|
2018-02-14 04:46:00 +00:00
|
|
|
if setting.API.EnableSwaggerEndpoint {
|
|
|
|
m.Get("/swagger", misc.Swagger) //Render V1 by default
|
|
|
|
}
|
2017-10-21 14:05:50 +00:00
|
|
|
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Group("/v1", func() {
|
|
|
|
// Miscellaneous
|
2018-02-14 04:46:00 +00:00
|
|
|
if setting.API.EnableSwaggerEndpoint {
|
|
|
|
m.Get("/swagger", misc.Swagger)
|
|
|
|
}
|
2017-03-06 14:13:17 +00:00
|
|
|
m.Get("/version", misc.Version)
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Post("/markdown", bind(api.MarkdownOption{}), misc.Markdown)
|
|
|
|
m.Post("/markdown/raw", misc.MarkdownRaw)
|
|
|
|
|
|
|
|
// Users
|
|
|
|
m.Group("/users", func() {
|
|
|
|
m.Get("/search", user.Search)
|
|
|
|
|
|
|
|
m.Group("/:username", func() {
|
|
|
|
m.Get("", user.GetInfo)
|
|
|
|
|
2017-02-24 21:39:49 +00:00
|
|
|
m.Get("/repos", user.ListUserRepos)
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Group("/tokens", func() {
|
|
|
|
m.Combo("").Get(user.ListAccessTokens).
|
|
|
|
Post(bind(api.CreateAccessTokenOption{}), user.CreateAccessToken)
|
2016-08-05 00:08:01 +00:00
|
|
|
}, reqBasicAuth())
|
2015-12-04 22:16:42 +00:00
|
|
|
})
|
|
|
|
})
|
|
|
|
|
|
|
|
m.Group("/users", func() {
|
|
|
|
m.Group("/:username", func() {
|
2015-12-05 22:13:13 +00:00
|
|
|
m.Get("/keys", user.ListPublicKeys)
|
2017-03-16 01:27:35 +00:00
|
|
|
m.Get("/gpg_keys", user.ListGPGKeys)
|
2015-12-21 12:24:11 +00:00
|
|
|
|
|
|
|
m.Get("/followers", user.ListFollowers)
|
|
|
|
m.Group("/following", func() {
|
|
|
|
m.Get("", user.ListFollowing)
|
|
|
|
m.Get("/:target", user.CheckFollowing)
|
|
|
|
})
|
2016-11-14 22:33:58 +00:00
|
|
|
|
|
|
|
m.Get("/starred", user.GetStarredRepos)
|
2016-12-24 01:53:11 +00:00
|
|
|
|
|
|
|
m.Get("/subscriptions", user.GetWatchedRepos)
|
2015-12-04 22:16:42 +00:00
|
|
|
})
|
2016-08-05 00:08:01 +00:00
|
|
|
}, reqToken())
|
2015-12-04 22:16:42 +00:00
|
|
|
|
|
|
|
m.Group("/user", func() {
|
2016-08-11 22:29:39 +00:00
|
|
|
m.Get("", user.GetAuthenticatedUser)
|
2015-12-21 12:24:11 +00:00
|
|
|
m.Combo("/emails").Get(user.ListEmails).
|
|
|
|
Post(bind(api.CreateEmailOption{}), user.AddEmail).
|
2017-11-13 07:02:25 +00:00
|
|
|
Delete(bind(api.DeleteEmailOption{}), user.DeleteEmail)
|
2015-12-21 12:24:11 +00:00
|
|
|
|
|
|
|
m.Get("/followers", user.ListMyFollowers)
|
|
|
|
m.Group("/following", func() {
|
|
|
|
m.Get("", user.ListMyFollowing)
|
|
|
|
m.Combo("/:username").Get(user.CheckMyFollowing).Put(user.Follow).Delete(user.Unfollow)
|
|
|
|
})
|
|
|
|
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Group("/keys", func() {
|
|
|
|
m.Combo("").Get(user.ListMyPublicKeys).
|
|
|
|
Post(bind(api.CreateKeyOption{}), user.CreatePublicKey)
|
|
|
|
m.Combo("/:id").Get(user.GetPublicKey).
|
|
|
|
Delete(user.DeletePublicKey)
|
|
|
|
})
|
2016-11-14 22:33:58 +00:00
|
|
|
|
2017-03-16 01:27:35 +00:00
|
|
|
m.Group("/gpg_keys", func() {
|
|
|
|
m.Combo("").Get(user.ListMyGPGKeys).
|
|
|
|
Post(bind(api.CreateGPGKeyOption{}), user.CreateGPGKey)
|
|
|
|
m.Combo("/:id").Get(user.GetGPGKey).
|
|
|
|
Delete(user.DeleteGPGKey)
|
|
|
|
})
|
|
|
|
|
2017-02-24 21:39:49 +00:00
|
|
|
m.Combo("/repos").Get(user.ListMyRepos).
|
|
|
|
Post(bind(api.CreateRepoOption{}), repo.Create)
|
|
|
|
|
2016-11-14 22:33:58 +00:00
|
|
|
m.Group("/starred", func() {
|
|
|
|
m.Get("", user.GetMyStarredRepos)
|
|
|
|
m.Group("/:username/:reponame", func() {
|
|
|
|
m.Get("", user.IsStarring)
|
|
|
|
m.Put("", user.Star)
|
|
|
|
m.Delete("", user.Unstar)
|
2016-12-29 13:17:32 +00:00
|
|
|
}, repoAssignment())
|
2016-11-14 22:33:58 +00:00
|
|
|
})
|
2017-09-12 06:48:13 +00:00
|
|
|
m.Get("/times", repo.ListMyTrackedTimes)
|
2016-12-24 01:53:11 +00:00
|
|
|
|
|
|
|
m.Get("/subscriptions", user.GetMyWatchedRepos)
|
2016-08-05 00:08:01 +00:00
|
|
|
}, reqToken())
|
2015-12-04 22:16:42 +00:00
|
|
|
|
|
|
|
// Repositories
|
2016-08-05 00:08:01 +00:00
|
|
|
m.Post("/org/:org/repos", reqToken(), bind(api.CreateRepoOption{}), repo.CreateOrgRepo)
|
2015-12-04 22:16:42 +00:00
|
|
|
|
|
|
|
m.Group("/repos", func() {
|
|
|
|
m.Get("/search", repo.Search)
|
|
|
|
})
|
|
|
|
|
2016-10-03 10:35:42 +00:00
|
|
|
m.Combo("/repositories/:id", reqToken()).Get(repo.GetByID)
|
|
|
|
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Group("/repos", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Post("/migrate", reqToken(), bind(auth.MigrateRepoForm{}), repo.Migrate)
|
2015-12-04 22:16:42 +00:00
|
|
|
|
|
|
|
m.Group("/:username/:reponame", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("").Get(repo.Get).Delete(reqToken(), repo.Delete)
|
2016-07-17 00:08:38 +00:00
|
|
|
m.Group("/hooks", func() {
|
|
|
|
m.Combo("").Get(repo.ListHooks).
|
|
|
|
Post(bind(api.CreateHookOption{}), repo.CreateHook)
|
2016-12-07 04:36:28 +00:00
|
|
|
m.Combo("/:id").Get(repo.GetHook).
|
|
|
|
Patch(bind(api.EditHookOption{}), repo.EditHook).
|
2016-07-17 00:08:38 +00:00
|
|
|
Delete(repo.DeleteHook)
|
2017-07-12 01:23:41 +00:00
|
|
|
}, reqToken(), reqRepoWriter())
|
2016-12-26 07:37:01 +00:00
|
|
|
m.Group("/collaborators", func() {
|
|
|
|
m.Get("", repo.ListCollaborators)
|
|
|
|
m.Combo("/:collaborator").Get(repo.IsCollaborator).
|
|
|
|
Put(bind(api.AddCollaboratorOption{}), repo.AddCollaborator).
|
|
|
|
Delete(repo.DeleteCollaborator)
|
2017-07-12 01:23:41 +00:00
|
|
|
}, reqToken())
|
2017-11-03 23:23:59 +00:00
|
|
|
m.Get("/raw/*", context.RepoRefByType(context.RepoRefAny), repo.GetRawFile)
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Get("/archive/*", repo.GetArchive)
|
2016-12-31 01:15:45 +00:00
|
|
|
m.Combo("/forks").Get(repo.ListForks).
|
2017-07-12 01:23:41 +00:00
|
|
|
Post(reqToken(), bind(api.CreateForkOption{}), repo.CreateFork)
|
2016-01-15 18:24:03 +00:00
|
|
|
m.Group("/branches", func() {
|
2016-03-11 16:56:52 +00:00
|
|
|
m.Get("", repo.ListBranches)
|
2017-10-30 02:04:25 +00:00
|
|
|
m.Get("/*", context.RepoRefByType(context.RepoRefBranch), repo.GetBranch)
|
2016-01-15 18:24:03 +00:00
|
|
|
})
|
2015-12-04 22:16:42 +00:00
|
|
|
m.Group("/keys", func() {
|
|
|
|
m.Combo("").Get(repo.ListDeployKeys).
|
|
|
|
Post(bind(api.CreateKeyOption{}), repo.CreateDeployKey)
|
|
|
|
m.Combo("/:id").Get(repo.GetDeployKey).
|
|
|
|
Delete(repo.DeleteDeploykey)
|
2017-07-26 09:01:11 +00:00
|
|
|
}, reqToken(), reqRepoWriter())
|
2017-09-12 06:48:13 +00:00
|
|
|
m.Group("/times", func() {
|
|
|
|
m.Combo("").Get(repo.ListTrackedTimesByRepository)
|
|
|
|
m.Combo("/:timetrackingusername").Get(repo.ListTrackedTimesByUser)
|
|
|
|
|
|
|
|
}, mustEnableIssues)
|
2016-03-14 03:20:22 +00:00
|
|
|
m.Group("/issues", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("").Get(repo.ListIssues).
|
|
|
|
Post(reqToken(), bind(api.CreateIssueOption{}), repo.CreateIssue)
|
2016-12-22 08:29:26 +00:00
|
|
|
m.Group("/comments", func() {
|
|
|
|
m.Get("", repo.ListRepoIssueComments)
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("/:id", reqToken()).
|
2017-11-20 07:24:07 +00:00
|
|
|
Patch(bind(api.EditIssueCommentOption{}), repo.EditIssueComment).
|
|
|
|
Delete(repo.DeleteIssueComment)
|
2016-12-22 08:29:26 +00:00
|
|
|
})
|
2016-08-03 16:24:16 +00:00
|
|
|
m.Group("/:index", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("").Get(repo.GetIssue).
|
|
|
|
Patch(reqToken(), bind(api.EditIssueOption{}), repo.EditIssue)
|
2016-08-26 18:23:21 +00:00
|
|
|
|
|
|
|
m.Group("/comments", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("").Get(repo.ListIssueComments).
|
|
|
|
Post(reqToken(), bind(api.CreateIssueCommentOption{}), repo.CreateIssueComment)
|
2017-11-20 07:24:07 +00:00
|
|
|
m.Combo("/:id", reqToken()).Patch(bind(api.EditIssueCommentOption{}), repo.EditIssueCommentDeprecated).
|
|
|
|
Delete(repo.DeleteIssueCommentDeprecated)
|
2016-08-26 18:23:21 +00:00
|
|
|
})
|
|
|
|
|
2016-08-03 16:24:16 +00:00
|
|
|
m.Group("/labels", func() {
|
2016-08-03 18:51:22 +00:00
|
|
|
m.Combo("").Get(repo.ListIssueLabels).
|
2017-07-12 01:23:41 +00:00
|
|
|
Post(reqToken(), bind(api.IssueLabelsOption{}), repo.AddIssueLabels).
|
|
|
|
Put(reqToken(), bind(api.IssueLabelsOption{}), repo.ReplaceIssueLabels).
|
|
|
|
Delete(reqToken(), repo.ClearIssueLabels)
|
|
|
|
m.Delete("/:id", reqToken(), repo.DeleteIssueLabel)
|
2016-08-03 16:24:16 +00:00
|
|
|
})
|
|
|
|
|
2017-09-12 06:48:13 +00:00
|
|
|
m.Group("/times", func() {
|
|
|
|
m.Combo("").Get(repo.ListTrackedTimes).
|
|
|
|
Post(reqToken(), bind(api.AddTimeOption{}), repo.AddTime)
|
|
|
|
})
|
2016-08-03 16:24:16 +00:00
|
|
|
})
|
2016-08-05 00:08:01 +00:00
|
|
|
}, mustEnableIssues)
|
2016-08-03 16:24:16 +00:00
|
|
|
m.Group("/labels", func() {
|
|
|
|
m.Combo("").Get(repo.ListLabels).
|
2017-07-12 01:23:41 +00:00
|
|
|
Post(reqToken(), bind(api.CreateLabelOption{}), repo.CreateLabel)
|
|
|
|
m.Combo("/:id").Get(repo.GetLabel).
|
|
|
|
Patch(reqToken(), bind(api.EditLabelOption{}), repo.EditLabel).
|
|
|
|
Delete(reqToken(), repo.DeleteLabel)
|
2016-03-13 22:49:16 +00:00
|
|
|
})
|
2016-08-24 22:18:56 +00:00
|
|
|
m.Group("/milestones", func() {
|
|
|
|
m.Combo("").Get(repo.ListMilestones).
|
2017-07-12 01:23:41 +00:00
|
|
|
Post(reqToken(), reqRepoWriter(), bind(api.CreateMilestoneOption{}), repo.CreateMilestone)
|
2016-08-24 23:05:56 +00:00
|
|
|
m.Combo("/:id").Get(repo.GetMilestone).
|
2017-07-12 01:23:41 +00:00
|
|
|
Patch(reqToken(), reqRepoWriter(), bind(api.EditMilestoneOption{}), repo.EditMilestone).
|
|
|
|
Delete(reqToken(), reqRepoWriter(), repo.DeleteMilestone)
|
2016-08-24 22:18:56 +00:00
|
|
|
})
|
2017-01-06 07:05:09 +00:00
|
|
|
m.Get("/stargazers", repo.ListStargazers)
|
2017-01-07 03:13:02 +00:00
|
|
|
m.Get("/subscribers", repo.ListSubscribers)
|
2016-12-24 01:53:11 +00:00
|
|
|
m.Group("/subscription", func() {
|
|
|
|
m.Get("", user.IsWatching)
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Put("", reqToken(), user.Watch)
|
|
|
|
m.Delete("", reqToken(), user.Unwatch)
|
2016-12-29 13:17:32 +00:00
|
|
|
})
|
2016-12-31 16:51:22 +00:00
|
|
|
m.Group("/releases", func() {
|
|
|
|
m.Combo("").Get(repo.ListReleases).
|
2018-01-16 08:54:13 +00:00
|
|
|
Post(reqToken(), reqRepoWriter(), context.ReferencesGitRepo(), bind(api.CreateReleaseOption{}), repo.CreateRelease)
|
2018-03-06 01:22:16 +00:00
|
|
|
m.Group("/:id", func() {
|
|
|
|
m.Combo("").Get(repo.GetRelease).
|
|
|
|
Patch(reqToken(), reqRepoWriter(), context.ReferencesGitRepo(), bind(api.EditReleaseOption{}), repo.EditRelease).
|
|
|
|
Delete(reqToken(), reqRepoWriter(), repo.DeleteRelease)
|
|
|
|
m.Group("/assets", func() {
|
|
|
|
m.Combo("").Get(repo.ListReleaseAttachments).
|
|
|
|
Post(reqToken(), reqRepoWriter(), repo.CreateReleaseAttachment)
|
|
|
|
m.Combo("/:asset").Get(repo.GetReleaseAttachment).
|
|
|
|
Patch(reqToken(), reqRepoWriter(), bind(api.EditAttachmentOptions{}), repo.EditReleaseAttachment).
|
|
|
|
Delete(reqToken(), reqRepoWriter(), repo.DeleteReleaseAttachment)
|
|
|
|
})
|
|
|
|
})
|
2016-12-31 16:51:22 +00:00
|
|
|
})
|
2017-07-26 09:01:11 +00:00
|
|
|
m.Post("/mirror-sync", reqToken(), reqRepoWriter(), repo.MirrorSync)
|
2016-08-30 23:18:40 +00:00
|
|
|
m.Get("/editorconfig/:filename", context.RepoRef(), repo.GetEditorconfig)
|
2016-12-02 11:10:39 +00:00
|
|
|
m.Group("/pulls", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("").Get(bind(api.ListPullRequestsOptions{}), repo.ListPullRequests).
|
|
|
|
Post(reqToken(), reqRepoWriter(), bind(api.CreatePullRequestOption{}), repo.CreatePullRequest)
|
2016-12-02 11:10:39 +00:00
|
|
|
m.Group("/:index", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("").Get(repo.GetPullRequest).
|
|
|
|
Patch(reqToken(), reqRepoWriter(), bind(api.EditPullRequestOption{}), repo.EditPullRequest)
|
|
|
|
m.Combo("/merge").Get(repo.IsPullRequestMerged).
|
2018-01-05 18:56:50 +00:00
|
|
|
Post(reqToken(), reqRepoWriter(), bind(auth.MergePullRequestForm{}), repo.MergePullRequest)
|
2016-12-02 11:10:39 +00:00
|
|
|
})
|
|
|
|
|
|
|
|
}, mustAllowPulls, context.ReferencesGitRepo())
|
2017-04-21 11:32:31 +00:00
|
|
|
m.Group("/statuses", func() {
|
2017-07-12 01:23:41 +00:00
|
|
|
m.Combo("/:sha").Get(repo.GetCommitStatuses).
|
|
|
|
Post(reqToken(), reqRepoWriter(), bind(api.CreateStatusOption{}), repo.NewCommitStatus)
|
2017-04-21 11:32:31 +00:00
|
|
|
})
|
|
|
|
m.Group("/commits/:ref", func() {
|
2017-11-13 07:02:25 +00:00
|
|
|
m.Get("/status", repo.GetCombinedCommitStatusByRef)
|
|
|
|
m.Get("/statuses", repo.GetCommitStatusesByRef)
|
2017-04-21 11:32:31 +00:00
|
|
|
})
|
2016-08-05 00:08:01 +00:00
|
|
|
}, repoAssignment())
|
2017-07-12 01:23:41 +00:00
|
|
|
})
|
2015-12-04 22:16:42 +00:00
|
|
|
|
2015-12-17 07:28:47 +00:00
|
|
|
// Organizations
|
2016-08-05 00:08:01 +00:00
|
|
|
m.Get("/user/orgs", reqToken(), org.ListMyOrgs)
|
2015-12-17 07:28:47 +00:00
|
|
|
m.Get("/users/:username/orgs", org.ListUserOrgs)
|
2016-03-21 16:53:04 +00:00
|
|
|
m.Group("/orgs/:orgname", func() {
|
2017-07-13 11:14:15 +00:00
|
|
|
m.Get("/repos", user.ListOrgRepos)
|
2017-01-26 11:54:04 +00:00
|
|
|
m.Combo("").Get(org.Get).
|
2017-06-07 16:20:32 +00:00
|
|
|
Patch(reqToken(), reqOrgOwnership(), bind(api.EditOrgOption{}), org.Edit)
|
2017-01-20 02:31:46 +00:00
|
|
|
m.Group("/members", func() {
|
|
|
|
m.Get("", org.ListMembers)
|
2017-01-26 11:54:04 +00:00
|
|
|
m.Combo("/:username").Get(org.IsMember).
|
2017-06-07 16:20:32 +00:00
|
|
|
Delete(reqToken(), reqOrgOwnership(), org.DeleteMember)
|
2017-01-20 02:31:46 +00:00
|
|
|
})
|
|
|
|
m.Group("/public_members", func() {
|
|
|
|
m.Get("", org.ListPublicMembers)
|
|
|
|
m.Combo("/:username").Get(org.IsPublicMember).
|
2017-06-07 16:20:32 +00:00
|
|
|
Put(reqToken(), reqOrgMembership(), org.PublicizeMember).
|
|
|
|
Delete(reqToken(), reqOrgMembership(), org.ConcealMember)
|
2017-01-20 02:31:46 +00:00
|
|
|
})
|
2017-06-07 16:20:32 +00:00
|
|
|
m.Combo("/teams", reqToken(), reqOrgMembership()).Get(org.ListTeams).
|
2017-01-20 13:47:09 +00:00
|
|
|
Post(bind(api.CreateTeamOption{}), org.CreateTeam)
|
2016-12-07 04:36:28 +00:00
|
|
|
m.Group("/hooks", func() {
|
|
|
|
m.Combo("").Get(org.ListHooks).
|
|
|
|
Post(bind(api.CreateHookOption{}), org.CreateHook)
|
|
|
|
m.Combo("/:id").Get(org.GetHook).
|
2017-01-14 02:14:48 +00:00
|
|
|
Patch(reqOrgOwnership(), bind(api.EditHookOption{}), org.EditHook).
|
|
|
|
Delete(reqOrgOwnership(), org.DeleteHook)
|
2017-06-07 16:20:32 +00:00
|
|
|
}, reqToken(), reqOrgMembership())
|
2016-08-05 00:08:01 +00:00
|
|
|
}, orgAssignment(true))
|
2016-12-28 01:36:04 +00:00
|
|
|
m.Group("/teams/:teamid", func() {
|
2017-01-20 05:16:10 +00:00
|
|
|
m.Combo("").Get(org.GetTeam).
|
2017-01-26 11:54:04 +00:00
|
|
|
Patch(reqOrgOwnership(), bind(api.EditTeamOption{}), org.EditTeam).
|
|
|
|
Delete(reqOrgOwnership(), org.DeleteTeam)
|
2017-01-20 05:16:10 +00:00
|
|
|
m.Group("/members", func() {
|
|
|
|
m.Get("", org.GetTeamMembers)
|
2017-01-26 11:54:04 +00:00
|
|
|
m.Combo("/:username").
|
|
|
|
Put(reqOrgOwnership(), org.AddTeamMember).
|
|
|
|
Delete(reqOrgOwnership(), org.RemoveTeamMember)
|
2017-01-20 05:16:10 +00:00
|
|
|
})
|
|
|
|
m.Group("/repos", func() {
|
|
|
|
m.Get("", org.GetTeamRepos)
|
2017-06-07 15:57:28 +00:00
|
|
|
m.Combo("/:orgname/:reponame").
|
2017-01-26 11:54:04 +00:00
|
|
|
Put(org.AddTeamRepository).
|
|
|
|
Delete(org.RemoveTeamRepository)
|
2017-01-20 05:16:10 +00:00
|
|
|
})
|
2017-06-07 16:20:32 +00:00
|
|
|
}, orgAssignment(false, true), reqToken(), reqOrgMembership())
|
2015-12-17 07:28:47 +00:00
|
|
|
|
2016-03-11 16:56:52 +00:00
|
|
|
m.Any("/*", func(ctx *context.Context) {
|
2015-12-04 22:16:42 +00:00
|
|
|
ctx.Error(404)
|
|
|
|
})
|
2015-12-05 22:13:13 +00:00
|
|
|
|
|
|
|
m.Group("/admin", func() {
|
|
|
|
m.Group("/users", func() {
|
|
|
|
m.Post("", bind(api.CreateUserOption{}), admin.CreateUser)
|
|
|
|
m.Group("/:username", func() {
|
|
|
|
m.Combo("").Patch(bind(api.EditUserOption{}), admin.EditUser).
|
|
|
|
Delete(admin.DeleteUser)
|
2017-12-06 10:27:10 +00:00
|
|
|
m.Group("/keys", func() {
|
|
|
|
m.Post("", bind(api.CreateKeyOption{}), admin.CreatePublicKey)
|
|
|
|
m.Delete("/:id", admin.DeleteUserPublicKey)
|
|
|
|
})
|
2015-12-17 07:28:47 +00:00
|
|
|
m.Post("/orgs", bind(api.CreateOrgOption{}), admin.CreateOrg)
|
2015-12-18 03:57:41 +00:00
|
|
|
m.Post("/repos", bind(api.CreateRepoOption{}), admin.CreateRepo)
|
2015-12-05 22:13:13 +00:00
|
|
|
})
|
|
|
|
})
|
2016-08-05 00:08:01 +00:00
|
|
|
}, reqAdmin())
|
2016-03-13 22:49:16 +00:00
|
|
|
}, context.APIContexter())
|
2015-12-04 22:16:42 +00:00
|
|
|
}
|