summaryrefslogtreecommitdiffstats
path: root/app/plugin/api.go
blob: accff9582d99fa5eda47712e7480f34d360c857c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Copyright (c) 2017-present Mattermost, Inc. All Rights Reserved.
// See License.txt for license information.

package plugin

import (
	"net/http"

	"github.com/gorilla/mux"
	"github.com/mattermost/mattermost-server/model"
)

type API interface {
	// Loads the plugin's configuration
	LoadPluginConfiguration(dest interface{}) error

	// The plugin's router
	PluginRouter() *mux.Router

	// Gets a team by its name
	GetTeamByName(name string) (*model.Team, *model.AppError)

	// Gets a user by its name
	GetUserByName(name string) (*model.User, *model.AppError)

	// Gets a channel by its name
	GetChannelByName(teamId, name string) (*model.Channel, *model.AppError)

	// Gets a direct message channel
	GetDirectChannel(userId1, userId2 string) (*model.Channel, *model.AppError)

	// Creates a post
	CreatePost(post *model.Post) (*model.Post, *model.AppError)

	// Get LDAP attributes for a user
	GetLdapUserAttributes(userId string, attributes []string) (map[string]string, *model.AppError)

	// Temporary for built-in plugins, copied from api4/context.go ServeHTTP function.
	// If a request has a valid token for an active session, the session is returned otherwise
	// it errors.
	GetSessionFromRequest(r *http.Request) (*model.Session, *model.AppError)

	// Returns a localized string. If a request is given, its headers will be used to pick a locale.
	I18n(id string, r *http.Request) string
}