gitea/routers/api/v1/user/user.go

176 lines
4.1 KiB
Go
Raw Normal View History

2014-05-01 03:48:01 +00:00
// Copyright 2014 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.
package user
2014-05-01 03:48:01 +00:00
import (
"net/http"
"strings"
"code.gitea.io/gitea/models"
"code.gitea.io/gitea/modules/context"
2017-10-25 05:30:29 +00:00
"code.gitea.io/gitea/modules/markup"
api "code.gitea.io/sdk/gitea"
"github.com/Unknwon/com"
2014-05-01 03:48:01 +00:00
)
2016-11-24 07:04:31 +00:00
// Search search users
func Search(ctx *context.APIContext) {
// swagger:operation GET /users/search user userSearch
// ---
// summary: Search for users
// produces:
// - application/json
// parameters:
// - name: q
// in: query
// description: keyword
// type: string
// - name: uid
// in: query
// description: ID of the user to search for
// type: integer
// format: int64
// - name: limit
// in: query
// description: maximum number of users to return
// type: integer
// responses:
// "200":
// description: "SearchResults of a successful search"
// schema:
// type: object
// properties:
// ok:
// type: boolean
// data:
// type: array
// items:
// "$ref": "#/definitions/User"
opts := &models.SearchUserOptions{
Keyword: strings.Trim(ctx.Query("q"), " "),
UID: com.StrTo(ctx.Query("uid")).MustInt64(),
2016-11-07 16:53:22 +00:00
Type: models.UserTypeIndividual,
PageSize: com.StrTo(ctx.Query("limit")).MustInt(),
2014-08-26 10:11:15 +00:00
}
if opts.PageSize <= 0 {
opts.PageSize = 10
2014-05-01 03:48:01 +00:00
}
users, _, err := models.SearchUsers(opts)
2014-05-01 03:48:01 +00:00
if err != nil {
2014-08-26 10:11:15 +00:00
ctx.JSON(500, map[string]interface{}{
"ok": false,
"error": err.Error(),
})
2014-05-01 03:48:01 +00:00
return
}
results := make([]*api.User, len(users))
for i := range users {
2014-11-14 22:11:30 +00:00
results[i] = &api.User{
2016-07-23 17:08:22 +00:00
ID: users[i].ID,
UserName: users[i].Name,
2016-11-29 08:25:47 +00:00
AvatarURL: users[i].AvatarLink(),
2017-10-25 05:26:14 +00:00
FullName: markup.Sanitize(users[i].FullName),
IsAdmin: users[i].IsAdmin,
2014-08-26 10:11:15 +00:00
}
if ctx.IsSigned && (!users[i].KeepEmailPrivate || ctx.User.IsAdmin) {
results[i].Email = users[i].Email
2015-08-18 21:47:45 +00:00
}
2014-05-01 03:48:01 +00:00
}
2015-11-17 07:18:05 +00:00
ctx.JSON(200, map[string]interface{}{
2014-05-01 03:48:01 +00:00
"ok": true,
"data": results,
})
}
2014-11-18 16:07:16 +00:00
2016-11-24 07:04:31 +00:00
// GetInfo get user's information
func GetInfo(ctx *context.APIContext) {
// swagger:operation GET /users/{username} user userGet
// ---
// summary: Get a user
// produces:
// - application/json
// parameters:
// - name: username
// in: path
// description: username of user to get
// type: string
// required: true
// responses:
// "200":
// "$ref": "#/responses/User"
// "404":
// "$ref": "#/responses/notFound"
2014-11-18 16:07:16 +00:00
u, err := models.GetUserByName(ctx.Params(":username"))
if err != nil {
2015-08-05 03:14:17 +00:00
if models.IsErrUserNotExist(err) {
2019-03-19 02:29:43 +00:00
ctx.NotFound()
2014-11-18 16:07:16 +00:00
} else {
ctx.Error(500, "GetUserByName", err)
2014-11-18 16:07:16 +00:00
}
return
}
// Hide user e-mail when API caller isn't signed in.
if !ctx.IsSigned {
u.Email = ""
}
ctx.JSON(200, u.APIFormat())
2016-08-11 22:29:39 +00:00
}
// GetAuthenticatedUser get current user's information
2016-08-11 22:29:39 +00:00
func GetAuthenticatedUser(ctx *context.APIContext) {
// swagger:operation GET /user user userGetCurrent
// ---
// summary: Get the authenticated user
// produces:
// - application/json
// responses:
// "200":
// "$ref": "#/responses/User"
ctx.JSON(200, ctx.User.APIFormat())
2014-11-18 16:07:16 +00:00
}
// GetUserHeatmapData is the handler to get a users heatmap
func GetUserHeatmapData(ctx *context.APIContext) {
// swagger:operation GET /users/{username}/heatmap user userGetHeatmapData
// ---
// summary: Get a user's heatmap
// produces:
// - application/json
// parameters:
// - name: username
// in: path
// description: username of user to get
// type: string
// required: true
// responses:
// "200":
// "$ref": "#/responses/UserHeatmapData"
// "404":
// "$ref": "#/responses/notFound"
// Get the user to throw an error if it does not exist
user, err := models.GetUserByName(ctx.Params(":username"))
if err != nil {
if models.IsErrUserNotExist(err) {
ctx.Status(http.StatusNotFound)
} else {
ctx.Error(http.StatusInternalServerError, "GetUserByName", err)
}
return
}
heatmap, err := models.GetUserHeatmapDataByUser(user)
if err != nil {
ctx.Error(http.StatusInternalServerError, "GetUserHeatmapDataByUser", err)
return
}
ctx.JSON(200, heatmap)
}