matterbridge/vendor/github.com/mattermost/platform/model/client.go

1901 lines
63 KiB
Go
Raw Normal View History

2016-04-10 21:39:38 +00:00
// Copyright (c) 2015 Mattermost, Inc. All Rights Reserved.
// See License.txt for license information.
package model
import (
"bytes"
"fmt"
l4g "github.com/alecthomas/log4go"
2016-07-22 21:14:13 +00:00
"io"
2016-04-10 21:39:38 +00:00
"io/ioutil"
2016-07-22 21:14:13 +00:00
"mime/multipart"
2016-04-10 21:39:38 +00:00
"net/http"
"net/url"
"strconv"
"strings"
"time"
)
const (
2016-05-15 21:02:30 +00:00
HEADER_REQUEST_ID = "X-Request-ID"
HEADER_VERSION_ID = "X-Version-ID"
2016-08-15 16:47:31 +00:00
HEADER_CLUSTER_ID = "X-Cluster-ID"
2016-05-15 21:02:30 +00:00
HEADER_ETAG_SERVER = "ETag"
HEADER_ETAG_CLIENT = "If-None-Match"
HEADER_FORWARDED = "X-Forwarded-For"
HEADER_REAL_IP = "X-Real-IP"
HEADER_FORWARDED_PROTO = "X-Forwarded-Proto"
HEADER_TOKEN = "token"
HEADER_BEARER = "BEARER"
HEADER_AUTH = "Authorization"
HEADER_REQUESTED_WITH = "X-Requested-With"
HEADER_REQUESTED_WITH_XML = "XMLHttpRequest"
2016-06-23 18:28:05 +00:00
STATUS = "status"
STATUS_OK = "OK"
2016-08-15 16:47:31 +00:00
STATUS_FAIL = "FAIL"
2016-05-15 21:02:30 +00:00
2016-09-17 13:19:18 +00:00
CLIENT_DIR = "webapp/dist"
2016-05-15 21:02:30 +00:00
API_URL_SUFFIX_V1 = "/api/v1"
API_URL_SUFFIX_V3 = "/api/v3"
API_URL_SUFFIX = API_URL_SUFFIX_V3
2016-04-10 21:39:38 +00:00
)
type Result struct {
RequestId string
Etag string
Data interface{}
}
type Client struct {
2016-06-23 18:28:05 +00:00
Url string // The location of the server like "http://localhost:8065"
ApiUrl string // The api location of the server like "http://localhost:8065/api/v3"
HttpClient *http.Client // The http client
AuthToken string
AuthType string
TeamId string
RequestId string
Etag string
ServerVersion string
2016-04-10 21:39:38 +00:00
}
// NewClient constructs a new client with convienence methods for talking to
// the server.
func NewClient(url string) *Client {
2016-06-23 18:28:05 +00:00
return &Client{url, url + API_URL_SUFFIX, &http.Client{}, "", "", "", "", "", ""}
}
func closeBody(r *http.Response) {
if r.Body != nil {
ioutil.ReadAll(r.Body)
r.Body.Close()
}
2016-05-15 21:02:30 +00:00
}
func (c *Client) SetOAuthToken(token string) {
c.AuthToken = token
c.AuthType = HEADER_TOKEN
}
func (c *Client) ClearOAuthToken() {
c.AuthToken = ""
c.AuthType = HEADER_BEARER
}
func (c *Client) SetTeamId(teamId string) {
c.TeamId = teamId
}
func (c *Client) GetTeamId() string {
if len(c.TeamId) == 0 {
println(`You are trying to use a route that requires a team_id,
but you have not called SetTeamId() in client.go`)
}
return c.TeamId
}
func (c *Client) ClearTeamId() {
c.TeamId = ""
}
func (c *Client) GetTeamRoute() string {
return fmt.Sprintf("/teams/%v", c.GetTeamId())
}
func (c *Client) GetChannelRoute(channelId string) string {
return fmt.Sprintf("/teams/%v/channels/%v", c.GetTeamId(), channelId)
}
func (c *Client) GetChannelNameRoute(channelName string) string {
return fmt.Sprintf("/teams/%v/channels/name/%v", c.GetTeamId(), channelName)
2016-04-10 21:39:38 +00:00
}
2016-07-22 21:14:13 +00:00
func (c *Client) GetEmojiRoute() string {
return "/emoji"
}
2016-06-23 18:28:05 +00:00
func (c *Client) GetGeneralRoute() string {
return "/general"
}
2016-04-10 21:39:38 +00:00
func (c *Client) DoPost(url, data, contentType string) (*http.Response, *AppError) {
rq, _ := http.NewRequest("POST", c.Url+url, strings.NewReader(data))
rq.Header.Set("Content-Type", contentType)
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-04-10 21:39:38 +00:00
return nil, AppErrorFromJson(rp.Body)
} else {
return rp, nil
}
}
func (c *Client) DoApiPost(url string, data string) (*http.Response, *AppError) {
rq, _ := http.NewRequest("POST", c.ApiUrl+url, strings.NewReader(data))
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, c.AuthType+" "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-04-10 21:39:38 +00:00
return nil, AppErrorFromJson(rp.Body)
} else {
return rp, nil
}
}
func (c *Client) DoApiGet(url string, data string, etag string) (*http.Response, *AppError) {
rq, _ := http.NewRequest("GET", c.ApiUrl+url, strings.NewReader(data))
if len(etag) > 0 {
rq.Header.Set(HEADER_ETAG_CLIENT, etag)
}
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, c.AuthType+" "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode == 304 {
return rp, nil
} else if rp.StatusCode >= 300 {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-04-10 21:39:38 +00:00
return rp, AppErrorFromJson(rp.Body)
} else {
return rp, nil
}
}
func getCookie(name string, resp *http.Response) *http.Cookie {
for _, cookie := range resp.Cookies() {
if cookie.Name == name {
return cookie
}
}
return nil
}
2016-06-23 18:28:05 +00:00
// Must is a convenience function used for testing.
2016-04-10 21:39:38 +00:00
func (c *Client) Must(result *Result, err *AppError) *Result {
if err != nil {
l4g.Close()
time.Sleep(time.Second)
panic(err)
}
return result
}
2016-07-22 21:14:13 +00:00
// MustGeneric is a convenience function used for testing.
func (c *Client) MustGeneric(result interface{}, err *AppError) interface{} {
if err != nil {
l4g.Close()
time.Sleep(time.Second)
panic(err)
}
return result
}
2016-06-23 18:28:05 +00:00
// CheckStatusOK is a convenience function for checking the return of Web Service
// call that return the a map of status=OK.
func (c *Client) CheckStatusOK(r *http.Response) bool {
m := MapFromJson(r.Body)
defer closeBody(r)
if m != nil && m[STATUS] == STATUS_OK {
return true
}
return false
}
func (c *Client) fillInExtraProperties(r *http.Response) {
c.RequestId = r.Header.Get(HEADER_REQUEST_ID)
c.Etag = r.Header.Get(HEADER_ETAG_SERVER)
c.ServerVersion = r.Header.Get(HEADER_VERSION_ID)
}
func (c *Client) clearExtraProperties() {
c.RequestId = ""
c.Etag = ""
c.ServerVersion = ""
}
// General Routes Section
// GetClientProperties returns properties needed by the client to show/hide
// certian features. It returns a map of strings.
func (c *Client) GetClientProperties() (map[string]string, *AppError) {
c.clearExtraProperties()
if r, err := c.DoApiGet(c.GetGeneralRoute()+"/client_props", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
c.fillInExtraProperties(r)
return MapFromJson(r.Body), nil
}
}
// LogClient is a convenience Web Service call so clients can log messages into
// the server-side logs. For example we typically log javascript error messages
// into the server-side. It returns true if the logging was successful.
func (c *Client) LogClient(message string) (bool, *AppError) {
c.clearExtraProperties()
m := make(map[string]string)
m["level"] = "ERROR"
m["message"] = message
if r, err := c.DoApiPost(c.GetGeneralRoute()+"/log_client", MapToJson(m)); err != nil {
return false, err
} else {
defer closeBody(r)
c.fillInExtraProperties(r)
return c.CheckStatusOK(r), nil
}
}
// GetPing returns a map of strings with server time, server version, and node Id.
// Systems that want to check on health status of the server should check the
// url /api/v3/ping for a 200 status response.
func (c *Client) GetPing() (map[string]string, *AppError) {
c.clearExtraProperties()
if r, err := c.DoApiGet(c.GetGeneralRoute()+"/ping", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
c.fillInExtraProperties(r)
return MapFromJson(r.Body), nil
}
}
// Team Routes Section
2016-08-15 16:47:31 +00:00
// SignupTeam sends an email with a team sign-up link to the provided address if email
// verification is enabled, otherwise it returns a map with a "follow_link" entry
// containing the team sign-up link.
2016-04-10 21:39:38 +00:00
func (c *Client) SignupTeam(email string, displayName string) (*Result, *AppError) {
m := make(map[string]string)
m["email"] = email
m["display_name"] = displayName
if r, err := c.DoApiPost("/teams/signup", MapToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// CreateTeamFromSignup creates a team based on the provided TeamSignup struct. On success
// it returns the TeamSignup struct.
2016-04-10 21:39:38 +00:00
func (c *Client) CreateTeamFromSignup(teamSignup *TeamSignup) (*Result, *AppError) {
if r, err := c.DoApiPost("/teams/create_from_signup", teamSignup.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), TeamSignupFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// CreateTeam creates a team based on the provided Team struct. On success it returns
// the Team struct with the Id, CreateAt and other server-decided fields populated.
2016-04-10 21:39:38 +00:00
func (c *Client) CreateTeam(team *Team) (*Result, *AppError) {
if r, err := c.DoApiPost("/teams/create", team.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), TeamFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetAllTeams returns a map of all teams using team ids as the key.
2016-04-10 21:39:38 +00:00
func (c *Client) GetAllTeams() (*Result, *AppError) {
if r, err := c.DoApiGet("/teams/all", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), TeamMapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetAllTeamListings returns a map of all teams that are available to join
// using team ids as the key. Must be authenticated.
2016-05-15 21:02:30 +00:00
func (c *Client) GetAllTeamListings() (*Result, *AppError) {
if r, err := c.DoApiGet("/teams/all_team_listings", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), TeamMapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// FindTeamByName returns the strings "true" or "false" depending on if a team
// with the provided name was found.
2016-05-15 21:02:30 +00:00
func (c *Client) FindTeamByName(name string) (*Result, *AppError) {
2016-04-10 21:39:38 +00:00
m := make(map[string]string)
m["name"] = name
if r, err := c.DoApiPost("/teams/find_team_by_name", MapToJson(m)); err != nil {
return nil, err
} else {
val := false
if body, _ := ioutil.ReadAll(r.Body); string(body) == "true" {
val = true
}
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), val}, nil
}
}
2016-07-22 21:14:13 +00:00
// Adds a user directly to the team without sending an invite.
// The teamId and userId are required. You must be a valid member of the team and/or
// have the correct role to add new users to the team. Returns a map of user_id=userId
// if successful, otherwise returns an AppError.
func (c *Client) AddUserToTeam(teamId string, userId string) (*Result, *AppError) {
if len(teamId) == 0 {
teamId = c.GetTeamId()
}
2016-05-15 21:02:30 +00:00
data := make(map[string]string)
data["user_id"] = userId
2016-07-22 21:14:13 +00:00
if r, err := c.DoApiPost(fmt.Sprintf("/teams/%v", teamId)+"/add_user_to_team", MapToJson(data)); err != nil {
2016-04-16 18:39:43 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-16 18:39:43 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-05-15 21:02:30 +00:00
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
2016-04-16 18:39:43 +00:00
}
}
2016-08-15 16:47:31 +00:00
// AddUserToTeamFromInvite adds a user to a team based off data provided in an invite link.
// Either hash and dataToHash are required or inviteId is required.
2016-05-15 21:02:30 +00:00
func (c *Client) AddUserToTeamFromInvite(hash, dataToHash, inviteId string) (*Result, *AppError) {
data := make(map[string]string)
data["hash"] = hash
data["data"] = dataToHash
data["invite_id"] = inviteId
if r, err := c.DoApiPost("/teams/add_user_to_team_from_invite", MapToJson(data)); err != nil {
2016-04-16 18:39:43 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-16 18:39:43 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-05-15 21:02:30 +00:00
r.Header.Get(HEADER_ETAG_SERVER), TeamFromJson(r.Body)}, nil
2016-04-16 18:39:43 +00:00
}
}
2016-07-22 21:14:13 +00:00
// Removes a user directly from the team.
// The teamId and userId are required. You must be a valid member of the team and/or
// have the correct role to remove a user from the team. Returns a map of user_id=userId
// if successful, otherwise returns an AppError.
func (c *Client) RemoveUserFromTeam(teamId string, userId string) (*Result, *AppError) {
if len(teamId) == 0 {
teamId = c.GetTeamId()
}
data := make(map[string]string)
data["user_id"] = userId
if r, err := c.DoApiPost(fmt.Sprintf("/teams/%v", teamId)+"/remove_user_from_team", MapToJson(data)); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) InviteMembers(invites *Invites) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/invite_members", invites.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), InvitesFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// UpdateTeam updates a team based on the changes in the provided team struct. On success
// it returns a sanitized version of the updated team. Must be authenticated as a team admin
// for that team or a system admin.
2016-04-10 21:39:38 +00:00
func (c *Client) UpdateTeam(team *Team) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/update", team.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// User Routes Section
// CreateUser creates a user in the system based on the provided user struct.
2016-04-10 21:39:38 +00:00
func (c *Client) CreateUser(user *User, hash string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/create", user.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// CreateUserWithInvite creates a user based on the provided user struct. Either the hash and
// data strings or the inviteId is required from the invite.
2016-05-15 21:02:30 +00:00
func (c *Client) CreateUserWithInvite(user *User, hash string, data string, inviteId string) (*Result, *AppError) {
url := "/users/create?d=" + url.QueryEscape(data) + "&h=" + url.QueryEscape(hash) + "&iid=" + url.QueryEscape(inviteId)
if r, err := c.DoApiPost(url, user.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) CreateUserFromSignup(user *User, data string, hash string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/create?d="+url.QueryEscape(data)+"&h="+hash, user.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetUser returns a user based on a provided user id string. Must be authenticated.
2016-04-10 21:39:38 +00:00
func (c *Client) GetUser(id string, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet("/users/"+id+"/get", "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetMe returns the current user.
2016-04-10 21:39:38 +00:00
func (c *Client) GetMe(etag string) (*Result, *AppError) {
if r, err := c.DoApiGet("/users/me", "", etag); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetProfilesForDirectMessageList returns a map of users for a team that can be direct
// messaged, using user id as the key. Must be authenticated.
2016-05-15 21:02:30 +00:00
func (c *Client) GetProfilesForDirectMessageList(teamId string) (*Result, *AppError) {
if r, err := c.DoApiGet("/users/profiles_for_dm_list/"+teamId, "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserMapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetProfiles returns a map of users for a team using user id as the key. Must
// be authenticated.
2016-04-10 21:39:38 +00:00
func (c *Client) GetProfiles(teamId string, etag string) (*Result, *AppError) {
if r, err := c.DoApiGet("/users/profiles/"+teamId, "", etag); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserMapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetDirectProfiles gets a map of users that are currently shown in the sidebar,
// using user id as the key. Must be authenticated.
2016-05-15 21:02:30 +00:00
func (c *Client) GetDirectProfiles(etag string) (*Result, *AppError) {
if r, err := c.DoApiGet("/users/direct_profiles", "", etag); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserMapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// LoginById authenticates a user by user id and password.
2016-04-10 21:39:38 +00:00
func (c *Client) LoginById(id string, password string) (*Result, *AppError) {
m := make(map[string]string)
m["id"] = id
m["password"] = password
return c.login(m)
}
2016-08-15 16:47:31 +00:00
// Login authenticates a user by login id, which can be username, email or some sort
// of SSO identifier based on configuration, and a password.
2016-05-15 21:02:30 +00:00
func (c *Client) Login(loginId string, password string) (*Result, *AppError) {
2016-04-10 21:39:38 +00:00
m := make(map[string]string)
2016-05-15 21:02:30 +00:00
m["login_id"] = loginId
2016-04-10 21:39:38 +00:00
m["password"] = password
return c.login(m)
}
2016-08-15 16:47:31 +00:00
// LoginByLdap authenticates a user by LDAP id and password.
2016-05-15 21:02:30 +00:00
func (c *Client) LoginByLdap(loginId string, password string) (*Result, *AppError) {
2016-04-10 21:39:38 +00:00
m := make(map[string]string)
2016-05-15 21:02:30 +00:00
m["login_id"] = loginId
2016-04-10 21:39:38 +00:00
m["password"] = password
2016-05-15 21:02:30 +00:00
m["ldap_only"] = "true"
2016-04-10 21:39:38 +00:00
return c.login(m)
}
2016-08-15 16:47:31 +00:00
// LoginWithDevice authenticates a user by login id (username, email or some sort
// of SSO identifier based on configuration), password and attaches a device id to
// the session.
2016-05-15 21:02:30 +00:00
func (c *Client) LoginWithDevice(loginId string, password string, deviceId string) (*Result, *AppError) {
2016-04-10 21:39:38 +00:00
m := make(map[string]string)
2016-05-15 21:02:30 +00:00
m["login_id"] = loginId
2016-04-10 21:39:38 +00:00
m["password"] = password
m["device_id"] = deviceId
return c.login(m)
}
func (c *Client) login(m map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/login", MapToJson(m)); err != nil {
return nil, err
} else {
c.AuthToken = r.Header.Get(HEADER_TOKEN)
c.AuthType = HEADER_BEARER
sessionToken := getCookie(SESSION_COOKIE_TOKEN, r)
if c.AuthToken != sessionToken.Value {
NewLocAppError("/users/login", "model.client.login.app_error", nil, "")
}
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// Logout terminates the current user's session.
2016-04-10 21:39:38 +00:00
func (c *Client) Logout() (*Result, *AppError) {
if r, err := c.DoApiPost("/users/logout", ""); err != nil {
return nil, err
} else {
c.AuthToken = ""
c.AuthType = HEADER_BEARER
2016-05-15 21:02:30 +00:00
c.TeamId = ""
2016-04-10 21:39:38 +00:00
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// CheckMfa returns a map with key "mfa_required" with the string value "true" or "false",
// indicating whether MFA is required to log the user in, based on a provided login id
// (username, email or some sort of SSO identifier based on configuration).
2016-05-15 21:02:30 +00:00
func (c *Client) CheckMfa(loginId string) (*Result, *AppError) {
m := make(map[string]string)
m["login_id"] = loginId
if r, err := c.DoApiPost("/users/mfa", MapToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
2016-04-10 21:39:38 +00:00
}
2016-08-15 16:47:31 +00:00
// GenerateMfaQrCode returns a QR code imagem containing the secret, to be scanned
// by a multi-factor authentication mobile application. Must be authenticated.
2016-05-15 21:02:30 +00:00
func (c *Client) GenerateMfaQrCode() (*Result, *AppError) {
if r, err := c.DoApiGet("/users/generate_mfa_qr", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), r.Body}, nil
}
}
2016-08-15 16:47:31 +00:00
// UpdateMfa activates multi-factor authenticates for the current user if activate
// is true and a valid token is provided. If activate is false, then token is not
// required and multi-factor authentication is disabled for the current user.
2016-05-15 21:02:30 +00:00
func (c *Client) UpdateMfa(activate bool, token string) (*Result, *AppError) {
m := make(map[string]interface{})
m["activate"] = activate
m["token"] = token
if r, err := c.DoApiPost("/users/update_mfa", StringInterfaceToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) AdminResetMfa(userId string) (*Result, *AppError) {
m := make(map[string]string)
m["user_id"] = userId
if r, err := c.DoApiPost("/admin/reset_mfa", MapToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
2016-04-10 21:39:38 +00:00
}
func (c *Client) RevokeSession(sessionAltId string) (*Result, *AppError) {
m := make(map[string]string)
m["id"] = sessionAltId
if r, err := c.DoApiPost("/users/revoke_session", MapToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) GetSessions(id string) (*Result, *AppError) {
if r, err := c.DoApiGet("/users/"+id+"/sessions", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), SessionsFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) EmailToOAuth(m map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/claim/email_to_sso", MapToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) OAuthToEmail(m map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/claim/oauth_to_email", MapToJson(m)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) LDAPToEmail(m map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/claim/ldap_to_email", MapToJson(m)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) EmailToLDAP(m map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/claim/ldap_to_email", MapToJson(m)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) Command(channelId string, command string, suggest bool) (*Result, *AppError) {
m := make(map[string]string)
m["command"] = command
m["channelId"] = channelId
m["suggest"] = strconv.FormatBool(suggest)
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/commands/execute", MapToJson(m)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), CommandResponseFromJson(r.Body)}, nil
}
}
func (c *Client) ListCommands() (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/commands/list", "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), CommandListFromJson(r.Body)}, nil
}
}
func (c *Client) ListTeamCommands() (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/commands/list_team_commands", "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), CommandListFromJson(r.Body)}, nil
}
}
func (c *Client) CreateCommand(cmd *Command) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/commands/create", cmd.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), CommandFromJson(r.Body)}, nil
}
}
func (c *Client) RegenCommandToken(data map[string]string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/commands/regen_token", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), CommandFromJson(r.Body)}, nil
}
}
func (c *Client) DeleteCommand(data map[string]string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/commands/delete", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) GetAudits(id string, etag string) (*Result, *AppError) {
if r, err := c.DoApiGet("/users/"+id+"/audits", "", etag); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), AuditsFromJson(r.Body)}, nil
}
}
func (c *Client) GetLogs() (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/logs", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ArrayFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
func (c *Client) GetClusterStatus() ([]*ClusterInfo, *AppError) {
if r, err := c.DoApiGet("/admin/cluster_status", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return ClusterInfosFromJson(r.Body), nil
}
}
2016-09-17 13:19:18 +00:00
// GetRecentlyActiveUsers returns a map of users including lastActivityAt using user id as the key
func (c *Client) GetRecentlyActiveUsers(teamId string) (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/recently_active_users/"+teamId, "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserMapFromJson(r.Body)}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) GetAllAudits() (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/audits", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), AuditsFromJson(r.Body)}, nil
}
}
2016-06-23 18:28:05 +00:00
func (c *Client) GetConfig() (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/config", "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-06-23 18:28:05 +00:00
r.Header.Get(HEADER_ETAG_SERVER), ConfigFromJson(r.Body)}, nil
2016-04-10 21:39:38 +00:00
}
}
2016-06-23 18:28:05 +00:00
// ReloadConfig will reload the config.json file from disk. Properties
// requiring a server restart will still need a server restart. You must
// have the system admin role to call this method. It will return status=OK
// if it's successfully reloaded the config file, otherwise check the returned error.
func (c *Client) ReloadConfig() (bool, *AppError) {
c.clearExtraProperties()
if r, err := c.DoApiGet("/admin/reload_config", "", ""); err != nil {
return false, err
2016-04-10 21:39:38 +00:00
} else {
2016-06-23 18:28:05 +00:00
c.fillInExtraProperties(r)
return c.CheckStatusOK(r), nil
2016-04-10 21:39:38 +00:00
}
}
func (c *Client) SaveConfig(config *Config) (*Result, *AppError) {
if r, err := c.DoApiPost("/admin/save_config", config.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-05-15 21:02:30 +00:00
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
2016-04-10 21:39:38 +00:00
}
}
2016-06-23 18:28:05 +00:00
// RecycleDatabaseConnection will attempt to recycle the database connections.
// You must have the system admin role to call this method. It will return status=OK
// if it's successfully recycled the connections, otherwise check the returned error.
func (c *Client) RecycleDatabaseConnection() (bool, *AppError) {
c.clearExtraProperties()
if r, err := c.DoApiGet("/admin/recycle_db_conn", "", ""); err != nil {
return false, err
} else {
c.fillInExtraProperties(r)
return c.CheckStatusOK(r), nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) TestEmail(config *Config) (*Result, *AppError) {
if r, err := c.DoApiPost("/admin/test_email", config.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-09-17 13:19:18 +00:00
// TestLdap will run a connection test on the current LDAP settings.
// It will return the standard OK response if settings work. Otherwise
// it will return an appropriate error.
func (c *Client) TestLdap(config *Config) (*Result, *AppError) {
if r, err := c.DoApiPost("/admin/ldap_test", config.ToJson()); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) GetComplianceReports() (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/compliance_reports", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), CompliancesFromJson(r.Body)}, nil
}
}
func (c *Client) SaveComplianceReport(job *Compliance) (*Result, *AppError) {
if r, err := c.DoApiPost("/admin/save_compliance_report", job.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ComplianceFromJson(r.Body)}, nil
}
}
func (c *Client) DownloadComplianceReport(id string) (*Result, *AppError) {
var rq *http.Request
rq, _ = http.NewRequest("GET", c.ApiUrl+"/admin/download_compliance_report/"+id, nil)
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, "BEARER "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError("/admin/download_compliance_report", "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
2016-06-23 18:28:05 +00:00
defer rp.Body.Close()
2016-05-15 21:02:30 +00:00
return nil, AppErrorFromJson(rp.Body)
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-05-15 21:02:30 +00:00
return &Result{rp.Header.Get(HEADER_REQUEST_ID),
rp.Header.Get(HEADER_ETAG_SERVER), rp.Body}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) GetTeamAnalytics(teamId, name string) (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/analytics/"+teamId+"/"+name, "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), AnalyticsRowsFromJson(r.Body)}, nil
}
}
func (c *Client) GetSystemAnalytics(name string) (*Result, *AppError) {
if r, err := c.DoApiGet("/admin/analytics/"+name, "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), AnalyticsRowsFromJson(r.Body)}, nil
}
}
2016-07-22 21:14:13 +00:00
// Initiate immediate synchronization of LDAP users.
// The synchronization will be performed asynchronously and this function will
// always return OK unless you don't have permissions.
// You must be the system administrator to use this function.
func (c *Client) LdapSyncNow() (*Result, *AppError) {
if r, err := c.DoApiPost("/admin/ldap_sync_now", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) CreateChannel(channel *Channel) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/channels/create", channel.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) CreateDirectChannel(userId string) (*Result, *AppError) {
data := make(map[string]string)
data["user_id"] = userId
if r, err := c.DoApiPost(c.GetTeamRoute()+"/channels/create_direct", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateChannel(channel *Channel) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/channels/update", channel.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateChannelHeader(data map[string]string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/channels/update_header", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateChannelPurpose(data map[string]string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/channels/update_purpose", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateNotifyProps(data map[string]string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/channels/update_notify_props", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) GetChannels(etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/channels/", "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelListFromJson(r.Body)}, nil
}
}
func (c *Client) GetChannel(id, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetChannelRoute(id)+"/", "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelDataFromJson(r.Body)}, nil
}
}
func (c *Client) GetMoreChannels(etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/channels/more", "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelListFromJson(r.Body)}, nil
}
}
func (c *Client) GetChannelCounts(etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/channels/counts", "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelCountsFromJson(r.Body)}, nil
}
}
func (c *Client) JoinChannel(id string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(id)+"/join", ""); err != nil {
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
func (c *Client) JoinChannelByName(name string) (*Result, *AppError) {
if r, err := c.DoApiPost(c.GetChannelNameRoute(name)+"/join", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
func (c *Client) LeaveChannel(id string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(id)+"/leave", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
func (c *Client) DeleteChannel(id string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(id)+"/delete", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
func (c *Client) AddChannelMember(id, user_id string) (*Result, *AppError) {
data := make(map[string]string)
data["user_id"] = user_id
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(id)+"/add", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
func (c *Client) RemoveChannelMember(id, user_id string) (*Result, *AppError) {
data := make(map[string]string)
data["user_id"] = user_id
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(id)+"/remove", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
2016-09-17 13:19:18 +00:00
// UpdateLastViewedAt will mark a channel as read.
// The channelId indicates the channel to mark as read. If active is true, push notifications
// will be cleared if there are unread messages. The default for active is true.
func (c *Client) UpdateLastViewedAt(channelId string, active bool) (*Result, *AppError) {
data := make(map[string]interface{})
data["active"] = active
if r, err := c.DoApiPost(c.GetChannelRoute(channelId)+"/update_last_viewed_at", StringInterfaceToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
func (c *Client) GetChannelExtraInfo(id string, memberLimit int, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetChannelRoute(id)+"/extra_info/"+strconv.FormatInt(int64(memberLimit), 10), "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), ChannelExtraFromJson(r.Body)}, nil
}
}
func (c *Client) CreatePost(post *Post) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(post.ChannelId)+"/posts/create", post.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostFromJson(r.Body)}, nil
}
}
func (c *Client) UpdatePost(post *Post) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(post.ChannelId)+"/posts/update", post.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostFromJson(r.Body)}, nil
}
}
func (c *Client) GetPosts(channelId string, offset int, limit int, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetChannelRoute(channelId)+fmt.Sprintf("/posts/page/%v/%v", offset, limit), "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
func (c *Client) GetPostsSince(channelId string, time int64) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetChannelRoute(channelId)+fmt.Sprintf("/posts/since/%v", time), "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
func (c *Client) GetPostsBefore(channelId string, postid string, offset int, limit int, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetChannelRoute(channelId)+fmt.Sprintf("/posts/%v/before/%v/%v", postid, offset, limit), "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
func (c *Client) GetPostsAfter(channelId string, postid string, offset int, limit int, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(fmt.Sprintf(c.GetChannelRoute(channelId)+"/posts/%v/after/%v/%v", postid, offset, limit), "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
func (c *Client) GetPost(channelId string, postId string, etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetChannelRoute(channelId)+fmt.Sprintf("/posts/%v/get", postId), "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
func (c *Client) DeletePost(channelId string, postId string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetChannelRoute(channelId)+fmt.Sprintf("/posts/%v/delete", postId), ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) SearchPosts(terms string, isOrSearch bool) (*Result, *AppError) {
data := map[string]interface{}{}
data["terms"] = terms
data["is_or_search"] = isOrSearch
if r, err := c.DoApiPost(c.GetTeamRoute()+"/posts/search", StringInterfaceToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetFlaggedPosts will return a post list of posts that have been flagged by the user.
// The page is set by the integer parameters offset and limit.
func (c *Client) GetFlaggedPosts(offset int, limit int) (*Result, *AppError) {
if r, err := c.DoApiGet(c.GetTeamRoute()+fmt.Sprintf("/posts/flagged/%v/%v", offset, limit), "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), PostListFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) UploadProfileFile(data []byte, contentType string) (*Result, *AppError) {
return c.uploadFile(c.ApiUrl+"/users/newimage", data, contentType)
}
func (c *Client) UploadPostAttachment(data []byte, contentType string) (*Result, *AppError) {
return c.uploadFile(c.ApiUrl+c.GetTeamRoute()+"/files/upload", data, contentType)
}
func (c *Client) uploadFile(url string, data []byte, contentType string) (*Result, *AppError) {
rq, _ := http.NewRequest("POST", url, bytes.NewReader(data))
2016-04-10 21:39:38 +00:00
rq.Header.Set("Content-Type", contentType)
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, "BEARER "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
return nil, AppErrorFromJson(rp.Body)
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-04-10 21:39:38 +00:00
return &Result{rp.Header.Get(HEADER_REQUEST_ID),
rp.Header.Get(HEADER_ETAG_SERVER), FileUploadResponseFromJson(rp.Body)}, nil
}
}
func (c *Client) GetFile(url string, isFullUrl bool) (*Result, *AppError) {
var rq *http.Request
if isFullUrl {
rq, _ = http.NewRequest("GET", url, nil)
} else {
2016-05-15 21:02:30 +00:00
rq, _ = http.NewRequest("GET", c.ApiUrl+c.GetTeamRoute()+"/files/get"+url, nil)
2016-04-10 21:39:38 +00:00
}
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, "BEARER "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
return nil, AppErrorFromJson(rp.Body)
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-04-10 21:39:38 +00:00
return &Result{rp.Header.Get(HEADER_REQUEST_ID),
rp.Header.Get(HEADER_ETAG_SERVER), rp.Body}, nil
}
}
func (c *Client) GetFileInfo(url string) (*Result, *AppError) {
var rq *http.Request
2016-05-15 21:02:30 +00:00
rq, _ = http.NewRequest("GET", c.ApiUrl+c.GetTeamRoute()+"/files/get_info"+url, nil)
2016-04-10 21:39:38 +00:00
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, "BEARER "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
return nil, AppErrorFromJson(rp.Body)
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(rp)
2016-04-10 21:39:38 +00:00
return &Result{rp.Header.Get(HEADER_REQUEST_ID),
rp.Header.Get(HEADER_ETAG_SERVER), FileInfoFromJson(rp.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) GetPublicLink(filename string) (*Result, *AppError) {
if r, err := c.DoApiPost(c.GetTeamRoute()+"/files/get_public_link", MapToJson(map[string]string{"filename": filename})); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-05-15 21:02:30 +00:00
r.Header.Get(HEADER_ETAG_SERVER), StringFromJson(r.Body)}, nil
2016-04-10 21:39:38 +00:00
}
}
func (c *Client) UpdateUser(user *User) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/update", user.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateUserRoles(data map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/update_roles", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-05-15 21:02:30 +00:00
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
2016-04-10 21:39:38 +00:00
}
}
func (c *Client) AttachDeviceId(deviceId string) (*Result, *AppError) {
data := make(map[string]string)
data["device_id"] = deviceId
if r, err := c.DoApiPost("/users/attach_device", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateActive(userId string, active bool) (*Result, *AppError) {
data := make(map[string]string)
data["user_id"] = userId
data["active"] = strconv.FormatBool(active)
if r, err := c.DoApiPost("/users/update_active", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateUserNotify(data map[string]string) (*Result, *AppError) {
if r, err := c.DoApiPost("/users/update_notify", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), UserFromJson(r.Body)}, nil
}
}
func (c *Client) UpdateUserPassword(userId, currentPassword, newPassword string) (*Result, *AppError) {
data := make(map[string]string)
data["current_password"] = currentPassword
data["new_password"] = newPassword
data["user_id"] = userId
if r, err := c.DoApiPost("/users/newpassword", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
2016-05-15 21:02:30 +00:00
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
2016-04-10 21:39:38 +00:00
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) SendPasswordReset(email string) (*Result, *AppError) {
data := map[string]string{}
data["email"] = email
2016-04-10 21:39:38 +00:00
if r, err := c.DoApiPost("/users/send_password_reset", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) ResetPassword(code, newPassword string) (*Result, *AppError) {
data := map[string]string{}
data["code"] = code
data["new_password"] = newPassword
2016-04-10 21:39:38 +00:00
if r, err := c.DoApiPost("/users/reset_password", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) AdminResetPassword(userId, newPassword string) (*Result, *AppError) {
data := map[string]string{}
data["user_id"] = userId
data["new_password"] = newPassword
if r, err := c.DoApiPost("/admin/reset_password", MapToJson(data)); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetStatuses returns a map of string statuses using user id as the key
func (c *Client) GetStatuses() (*Result, *AppError) {
if r, err := c.DoApiGet("/users/status", "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-09-17 13:19:18 +00:00
// SetActiveChannel sets the the channel id the user is currently viewing.
// The channelId key is required but the value can be blank. Returns standard
// response.
func (c *Client) SetActiveChannel(channelId string) (*Result, *AppError) {
data := map[string]string{}
data["channel_id"] = channelId
if r, err := c.DoApiPost("/users/status/set_active_channel", MapToJson(data)); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) GetMyTeam(etag string) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/me", "", etag); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), TeamFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) GetTeamMembers(teamId string) (*Result, *AppError) {
if r, err := c.DoApiGet("/teams/members/"+teamId, "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), TeamMembersFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// RegisterApp creates a new OAuth2 app to be used with the OAuth2 Provider. On success
// it returns the created app. Must be authenticated as a user.
2016-04-10 21:39:38 +00:00
func (c *Client) RegisterApp(app *OAuthApp) (*Result, *AppError) {
if r, err := c.DoApiPost("/oauth/register", app.ToJson()); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OAuthAppFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// AllowOAuth allows a new session by an OAuth2 App. On success
// it returns the url to be redirected back to the app which initiated the oauth2 flow.
// Must be authenticated as a user.
2016-04-10 21:39:38 +00:00
func (c *Client) AllowOAuth(rspType, clientId, redirect, scope, state string) (*Result, *AppError) {
if r, err := c.DoApiGet("/oauth/allow?response_type="+rspType+"&client_id="+clientId+"&redirect_uri="+url.QueryEscape(redirect)+"&scope="+scope+"&state="+url.QueryEscape(state), "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-08-15 16:47:31 +00:00
// GetOAuthAppsByUser returns the OAuth2 Apps registered by the user. On success
// it returns a list of OAuth2 Apps from the same user or all the registered apps if the user
// is a System Administrator. Must be authenticated as a user.
func (c *Client) GetOAuthAppsByUser() (*Result, *AppError) {
if r, err := c.DoApiGet("/oauth/list", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OAuthAppListFromJson(r.Body)}, nil
}
}
// GetOAuthAppInfo lookup an OAuth2 App using the client_id. On success
// it returns a Sanitized OAuth2 App. Must be authenticated as a user.
func (c *Client) GetOAuthAppInfo(clientId string) (*Result, *AppError) {
if r, err := c.DoApiGet("/oauth/app/"+clientId, "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OAuthAppFromJson(r.Body)}, nil
}
}
// DeleteOAuthApp deletes an OAuth2 app, the app must be deleted by the same user who created it or
// a System Administrator. On success returs Status OK. Must be authenticated as a user.
func (c *Client) DeleteOAuthApp(id string) (*Result, *AppError) {
data := make(map[string]string)
data["id"] = id
if r, err := c.DoApiPost("/oauth/delete", MapToJson(data)); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
2016-09-17 13:19:18 +00:00
// GetOAuthAuthorizedApps returns the OAuth2 Apps authorized by the user. On success
// it returns a list of sanitized OAuth2 Authorized Apps by the user.
func (c *Client) GetOAuthAuthorizedApps() (*Result, *AppError) {
if r, err := c.DoApiGet("/oauth/authorized", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OAuthAppListFromJson(r.Body)}, nil
}
}
// OAuthDeauthorizeApp deauthorize a user an OAuth 2.0 app. On success
// it returns status OK or an AppError on fail.
func (c *Client) OAuthDeauthorizeApp(clientId string) *AppError {
if r, err := c.DoApiPost("/oauth/"+clientId+"/deauthorize", ""); err != nil {
return err
} else {
defer closeBody(r)
return nil
}
}
// RegenerateOAuthAppSecret generates a new OAuth App Client Secret. On success
// it returns an OAuth2 App. Must be authenticated as a user and the same user who
// registered the app or a System Admin.
func (c *Client) RegenerateOAuthAppSecret(clientId string) (*Result, *AppError) {
if r, err := c.DoApiPost("/oauth/"+clientId+"/regen_secret", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OAuthAppFromJson(r.Body)}, nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) GetAccessToken(data url.Values) (*Result, *AppError) {
2016-08-15 16:47:31 +00:00
if r, err := c.DoPost("/oauth/access_token", data.Encode(), "application/x-www-form-urlencoded"); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), AccessResponseFromJson(r.Body)}, nil
}
}
func (c *Client) CreateIncomingWebhook(hook *IncomingWebhook) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/hooks/incoming/create", hook.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), IncomingWebhookFromJson(r.Body)}, nil
}
}
func (c *Client) PostToWebhook(id, payload string) (*Result, *AppError) {
if r, err := c.DoPost("/hooks/"+id, payload, "application/x-www-form-urlencoded"); err != nil {
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), nil}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) DeleteIncomingWebhook(id string) (*Result, *AppError) {
data := make(map[string]string)
data["id"] = id
if r, err := c.DoApiPost(c.GetTeamRoute()+"/hooks/incoming/delete", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) ListIncomingWebhooks() (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/hooks/incoming/list", "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), IncomingWebhookListFromJson(r.Body)}, nil
}
}
func (c *Client) GetAllPreferences() (*Result, *AppError) {
if r, err := c.DoApiGet("/preferences/", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
preferences, _ := PreferencesFromJson(r.Body)
return &Result{r.Header.Get(HEADER_REQUEST_ID), r.Header.Get(HEADER_ETAG_SERVER), preferences}, nil
}
}
func (c *Client) SetPreferences(preferences *Preferences) (*Result, *AppError) {
if r, err := c.DoApiPost("/preferences/save", preferences.ToJson()); err != nil {
return nil, err
} else {
2016-07-22 21:14:13 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), preferences}, nil
}
}
func (c *Client) GetPreference(category string, name string) (*Result, *AppError) {
if r, err := c.DoApiGet("/preferences/"+category+"/"+name, "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID), r.Header.Get(HEADER_ETAG_SERVER), PreferenceFromJson(r.Body)}, nil
}
}
func (c *Client) GetPreferenceCategory(category string) (*Result, *AppError) {
if r, err := c.DoApiGet("/preferences/"+category, "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
preferences, _ := PreferencesFromJson(r.Body)
return &Result{r.Header.Get(HEADER_REQUEST_ID), r.Header.Get(HEADER_ETAG_SERVER), preferences}, nil
}
}
2016-08-15 16:47:31 +00:00
// DeletePreferences deletes a list of preferences owned by the current user. If successful,
// it will return status=ok. Otherwise, an error will be returned.
func (c *Client) DeletePreferences(preferences *Preferences) (bool, *AppError) {
if r, err := c.DoApiPost("/preferences/delete", preferences.ToJson()); err != nil {
return false, err
} else {
return c.CheckStatusOK(r), nil
}
}
2016-04-10 21:39:38 +00:00
func (c *Client) CreateOutgoingWebhook(hook *OutgoingWebhook) (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiPost(c.GetTeamRoute()+"/hooks/outgoing/create", hook.ToJson()); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OutgoingWebhookFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) DeleteOutgoingWebhook(id string) (*Result, *AppError) {
data := make(map[string]string)
data["id"] = id
if r, err := c.DoApiPost(c.GetTeamRoute()+"/hooks/outgoing/delete", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) ListOutgoingWebhooks() (*Result, *AppError) {
2016-05-15 21:02:30 +00:00
if r, err := c.DoApiGet(c.GetTeamRoute()+"/hooks/outgoing/list", "", ""); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OutgoingWebhookListFromJson(r.Body)}, nil
}
}
2016-05-15 21:02:30 +00:00
func (c *Client) RegenOutgoingWebhookToken(id string) (*Result, *AppError) {
data := make(map[string]string)
data["id"] = id
if r, err := c.DoApiPost(c.GetTeamRoute()+"/hooks/outgoing/regen_token", MapToJson(data)); err != nil {
2016-04-10 21:39:38 +00:00
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-04-10 21:39:38 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), OutgoingWebhookFromJson(r.Body)}, nil
}
}
func (c *Client) MockSession(sessionToken string) {
c.AuthToken = sessionToken
c.AuthType = HEADER_BEARER
}
2016-05-15 21:02:30 +00:00
func (c *Client) GetClientLicenceConfig(etag string) (*Result, *AppError) {
if r, err := c.DoApiGet("/license/client_config", "", etag); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), MapFromJson(r.Body)}, nil
}
}
func (c *Client) GetInitialLoad() (*Result, *AppError) {
if r, err := c.DoApiGet("/users/initial_load", "", ""); err != nil {
return nil, err
} else {
2016-06-23 18:28:05 +00:00
defer closeBody(r)
2016-05-15 21:02:30 +00:00
return &Result{r.Header.Get(HEADER_REQUEST_ID),
r.Header.Get(HEADER_ETAG_SERVER), InitialLoadFromJson(r.Body)}, nil
}
}
2016-07-22 21:14:13 +00:00
// ListEmoji returns a list of all user-created emoji for the server.
func (c *Client) ListEmoji() ([]*Emoji, *AppError) {
if r, err := c.DoApiGet(c.GetEmojiRoute()+"/list", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
c.fillInExtraProperties(r)
return EmojiListFromJson(r.Body), nil
}
}
// CreateEmoji will save an emoji to the server if the current user has permission
// to do so. If successful, the provided emoji will be returned with its Id field
// filled in. Otherwise, an error will be returned.
func (c *Client) CreateEmoji(emoji *Emoji, image []byte, filename string) (*Emoji, *AppError) {
c.clearExtraProperties()
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
if part, err := writer.CreateFormFile("image", filename); err != nil {
return nil, NewLocAppError("CreateEmoji", "model.client.create_emoji.image.app_error", nil, err.Error())
} else if _, err = io.Copy(part, bytes.NewBuffer(image)); err != nil {
return nil, NewLocAppError("CreateEmoji", "model.client.create_emoji.image.app_error", nil, err.Error())
}
if err := writer.WriteField("emoji", emoji.ToJson()); err != nil {
return nil, NewLocAppError("CreateEmoji", "model.client.create_emoji.emoji.app_error", nil, err.Error())
}
if err := writer.Close(); err != nil {
return nil, NewLocAppError("CreateEmoji", "model.client.create_emoji.writer.app_error", nil, err.Error())
}
rq, _ := http.NewRequest("POST", c.ApiUrl+c.GetEmojiRoute()+"/create", body)
rq.Header.Set("Content-Type", writer.FormDataContentType())
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, "BEARER "+c.AuthToken)
}
if r, err := c.HttpClient.Do(rq); err != nil {
return nil, NewLocAppError("CreateEmoji", "model.client.connecting.app_error", nil, err.Error())
} else if r.StatusCode >= 300 {
return nil, AppErrorFromJson(r.Body)
} else {
defer closeBody(r)
c.fillInExtraProperties(r)
return EmojiFromJson(r.Body), nil
}
}
// DeleteEmoji will delete an emoji from the server if the current user has permission
// to do so. If successful, it will return status=ok. Otherwise, an error will be returned.
func (c *Client) DeleteEmoji(id string) (bool, *AppError) {
data := map[string]string{"id": id}
if r, err := c.DoApiPost(c.GetEmojiRoute()+"/delete", MapToJson(data)); err != nil {
return false, err
} else {
c.fillInExtraProperties(r)
return c.CheckStatusOK(r), nil
}
}
// GetCustomEmojiImageUrl returns the API route that can be used to get the image used by
// the given emoji.
func (c *Client) GetCustomEmojiImageUrl(id string) string {
return c.GetEmojiRoute() + "/" + id
}
2016-08-15 16:47:31 +00:00
// Uploads a x509 base64 Certificate or Private Key file to be used with SAML.
// data byte array is required and needs to be a Multi-Part with 'certificate' as the field name
// contentType is also required. Returns nil if succesful, otherwise returns an AppError
func (c *Client) UploadCertificateFile(data []byte, contentType string) *AppError {
url := c.ApiUrl + "/admin/add_certificate"
rq, _ := http.NewRequest("POST", url, bytes.NewReader(data))
rq.Header.Set("Content-Type", contentType)
if len(c.AuthToken) > 0 {
rq.Header.Set(HEADER_AUTH, "BEARER "+c.AuthToken)
}
if rp, err := c.HttpClient.Do(rq); err != nil {
return NewLocAppError(url, "model.client.connecting.app_error", nil, err.Error())
} else if rp.StatusCode >= 300 {
return AppErrorFromJson(rp.Body)
} else {
defer closeBody(rp)
return nil
}
}
// Removes a x509 base64 Certificate or Private Key file used with SAML.
// filename is required. Returns nil if successful, otherwise returns an AppError
func (c *Client) RemoveCertificateFile(filename string) *AppError {
if r, err := c.DoApiPost("/admin/remove_certificate", MapToJson(map[string]string{"filename": filename})); err != nil {
return err
} else {
defer closeBody(r)
return nil
}
}
// Checks if the x509 base64 Certificates and Private Key files used with SAML exists on the file system.
// Returns a map[string]interface{} if successful, otherwise returns an AppError. Must be System Admin authenticated.
func (c *Client) SamlCertificateStatus(filename string) (map[string]interface{}, *AppError) {
if r, err := c.DoApiGet("/admin/remove_certificate", "", ""); err != nil {
return nil, err
} else {
defer closeBody(r)
return StringInterfaceFromJson(r.Body), nil
}
}