account.go
author Mikael Berthe <mikael@lilotux.net>
Mon, 29 Jul 2019 21:57:47 +0200
changeset 253 0e8c8026cf40
parent 243 7386c6a454a8
permissions -rw-r--r--
Update dependencies
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
130
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 125
diff changeset
     1
/*
207
301d5b94be3f Update copyrights
Mikael Berthe <mikael@lilotux.net>
parents: 206
diff changeset
     2
Copyright 2017-2018 Mikael Berthe
130
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 125
diff changeset
     3
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 125
diff changeset
     4
Licensed under the MIT license.  Please see the LICENSE file is this directory.
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 125
diff changeset
     5
*/
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 125
diff changeset
     6
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 134
diff changeset
     7
package madon
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
     8
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
     9
import (
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    10
	"bytes"
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    11
	"encoding/json"
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    12
	"fmt"
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    13
	"mime/multipart"
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    14
	"os"
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
    15
	"path/filepath"
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    16
	"strconv"
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    17
162
68df3a01e1a7 Use github.com/pkg/errors
Mikael Berthe <mikael@lilotux.net>
parents: 161
diff changeset
    18
	"github.com/pkg/errors"
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    19
	"github.com/sendgrid/rest"
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    20
)
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    21
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    22
// getAccountsOptions contains option fields for POST and DELETE API calls
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    23
type getAccountsOptions struct {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    24
	// The ID is used for most commands
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
    25
	ID int64
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    26
206
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
    27
	// Following can be set to true to limit a search to "following" accounts
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
    28
	Following bool
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
    29
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
    30
	// The Q field (query) is used when searching for accounts
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
    31
	Q string
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
    32
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
    33
	Limit *LimitParams
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    34
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    35
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
    36
// UpdateAccountParams contains option fields for the UpdateAccount command
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
    37
type UpdateAccountParams struct {
232
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    38
	DisplayName      *string
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    39
	Note             *string
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    40
	AvatarImagePath  *string
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    41
	HeaderImagePath  *string
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    42
	Locked           *bool
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    43
	Bot              *bool
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    44
	FieldsAttributes *[]Field
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
    45
	Source           *SourceParams
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
    46
}
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
    47
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    48
// updateRelationship returns a Relationship entity
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    49
// The operation 'op' can be "follow", "unfollow", "block", "unblock",
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    50
// "mute", "unmute".
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    51
// The id is optional and depends on the operation.
205
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
    52
func (mc *Client) updateRelationship(op string, id int64, params apiCallParams) (*Relationship, error) {
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    53
	var endPoint string
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    54
	method := rest.Post
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    55
	strID := strconv.FormatInt(id, 10)
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    56
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    57
	switch op {
235
263da7f71f03 Add endorsement commands (GetEndorsements, {Pin,Unpin}Account)
Mikael Berthe <mikael@lilotux.net>
parents: 232
diff changeset
    58
	case "follow", "unfollow", "block", "unblock", "mute", "unmute", "pin", "unpin":
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    59
		endPoint = "accounts/" + strID + "/" + op
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    60
	default:
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    61
		return nil, ErrInvalidParameter
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    62
	}
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    63
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    64
	var rel Relationship
238
1c0042e76902 Do not use a global API version
Mikael Berthe <mikael@lilotux.net>
parents: 235
diff changeset
    65
	if err := mc.apiCall("v1/"+endPoint, method, params, nil, nil, &rel); err != nil {
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    66
		return nil, err
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    67
	}
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    68
	return &rel, nil
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    69
}
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    70
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    71
// getSingleAccount returns an account entity
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
    72
// The operation 'op' can be "account", "verify_credentials",
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
    73
// "follow_requests/authorize" or // "follow_requests/reject".
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
    74
// The id is optional and depends on the operation.
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
    75
func (mc *Client) getSingleAccount(op string, id int64) (*Account, error) {
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    76
	var endPoint string
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    77
	method := rest.Get
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
    78
	strID := strconv.FormatInt(id, 10)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    79
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
    80
	switch op {
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    81
	case "account":
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    82
		endPoint = "accounts/" + strID
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    83
	case "verify_credentials":
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    84
		endPoint = "accounts/verify_credentials"
115
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
    85
	case "follow_requests/authorize", "follow_requests/reject":
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
    86
		// The documentation is incorrect, the endpoint actually
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
    87
		// is "follow_requests/:id/{authorize|reject}"
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
    88
		endPoint = op[:16] + strID + "/" + op[16:]
115
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
    89
		method = rest.Post
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    90
	default:
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    91
		return nil, ErrInvalidParameter
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    92
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    93
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    94
	var account Account
238
1c0042e76902 Do not use a global API version
Mikael Berthe <mikael@lilotux.net>
parents: 235
diff changeset
    95
	if err := mc.apiCall("v1/"+endPoint, method, nil, nil, nil, &account); err != nil {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
    96
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    97
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    98
	return &account, nil
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
    99
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   100
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   101
// getMultipleAccounts returns a list of account entities
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   102
// If lopt.All is true, several requests will be made until the API server
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   103
// has nothing to return.
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   104
func (mc *Client) getMultipleAccounts(endPoint string, params apiCallParams, lopt *LimitParams) ([]Account, error) {
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   105
	var accounts []Account
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   106
	var links apiLinks
238
1c0042e76902 Do not use a global API version
Mikael Berthe <mikael@lilotux.net>
parents: 235
diff changeset
   107
	if err := mc.apiCall("v1/"+endPoint, rest.Get, params, lopt, &links, &accounts); err != nil {
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   108
		return nil, err
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   109
	}
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   110
	if lopt != nil { // Fetch more pages to reach our limit
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   111
		var accountSlice []Account
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   112
		for (lopt.All || lopt.Limit > len(accounts)) && links.next != nil {
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   113
			newlopt := links.next
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   114
			links = apiLinks{}
238
1c0042e76902 Do not use a global API version
Mikael Berthe <mikael@lilotux.net>
parents: 235
diff changeset
   115
			if err := mc.apiCall("v1/"+endPoint, rest.Get, params, newlopt, &links, &accountSlice); err != nil {
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   116
				return nil, err
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   117
			}
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   118
			accounts = append(accounts, accountSlice...)
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   119
			accountSlice = accountSlice[:0] // Clear struct
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   120
		}
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   121
	}
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   122
	return accounts, nil
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   123
}
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   124
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   125
// getMultipleAccountsHelper returns a list of account entities
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   126
// The operation 'op' can be "followers", "following", "search", "blocks",
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   127
// "mutes", "follow_requests".
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   128
// The id is optional and depends on the operation.
156
70aadba26338 Add field "All" to LimitParams, change Limit behaviour
Mikael Berthe <mikael@lilotux.net>
parents: 155
diff changeset
   129
// If opts.All is true, several requests will be made until the API server
70aadba26338 Add field "All" to LimitParams, change Limit behaviour
Mikael Berthe <mikael@lilotux.net>
parents: 155
diff changeset
   130
// has nothing to return.
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   131
func (mc *Client) getMultipleAccountsHelper(op string, opts *getAccountsOptions) ([]Account, error) {
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   132
	var endPoint string
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   133
	var lopt *LimitParams
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   134
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   135
	if opts != nil {
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   136
		lopt = opts.Limit
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   137
	}
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   138
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   139
	switch op {
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   140
	case "followers", "following":
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   141
		if opts == nil || opts.ID < 1 {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   142
			return []Account{}, ErrInvalidID
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   143
		}
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   144
		endPoint = "accounts/" + strconv.FormatInt(opts.ID, 10) + "/" + op
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   145
	case "follow_requests", "blocks", "mutes":
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   146
		endPoint = op
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   147
	case "search":
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   148
		if opts == nil || opts.Q == "" {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   149
			return []Account{}, ErrInvalidParameter
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   150
		}
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   151
		endPoint = "accounts/" + op
155
0c581e0108da Use links from headers
Mikael Berthe <mikael@lilotux.net>
parents: 152
diff changeset
   152
	case "reblogged_by", "favourited_by":
0c581e0108da Use links from headers
Mikael Berthe <mikael@lilotux.net>
parents: 152
diff changeset
   153
		if opts == nil || opts.ID < 1 {
0c581e0108da Use links from headers
Mikael Berthe <mikael@lilotux.net>
parents: 152
diff changeset
   154
			return []Account{}, ErrInvalidID
0c581e0108da Use links from headers
Mikael Berthe <mikael@lilotux.net>
parents: 152
diff changeset
   155
		}
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   156
		endPoint = "statuses/" + strconv.FormatInt(opts.ID, 10) + "/" + op
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   157
	default:
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   158
		return nil, ErrInvalidParameter
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   159
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   160
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   161
	// Handle target-specific query parameters
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   162
	params := make(apiCallParams)
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   163
	if op == "search" {
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   164
		params["q"] = opts.Q
206
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
   165
		if opts.Following {
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
   166
			params["following"] = "true"
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
   167
		}
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   168
	}
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   169
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   170
	return mc.getMultipleAccounts(endPoint, params, lopt)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   171
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   172
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   173
// GetAccount returns an account entity
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   174
// The returned value can be nil if there is an error or if the
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   175
// requested ID does not exist.
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   176
func (mc *Client) GetAccount(accountID int64) (*Account, error) {
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 134
diff changeset
   177
	account, err := mc.getSingleAccount("account", accountID)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   178
	if err != nil {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   179
		return nil, err
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   180
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   181
	if account != nil && account.ID == 0 {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   182
		return nil, ErrEntityNotFound
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   183
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   184
	return account, nil
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   185
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   186
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   187
// GetCurrentAccount returns the current user account
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 134
diff changeset
   188
func (mc *Client) GetCurrentAccount() (*Account, error) {
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 134
diff changeset
   189
	account, err := mc.getSingleAccount("verify_credentials", 0)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   190
	if err != nil {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   191
		return nil, err
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   192
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   193
	if account != nil && account.ID == 0 {
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   194
		return nil, ErrEntityNotFound
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   195
	}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   196
	return account, nil
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   197
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   198
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   199
// GetAccountFollowers returns the list of accounts following a given account
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   200
func (mc *Client) GetAccountFollowers(accountID int64, lopt *LimitParams) ([]Account, error) {
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   201
	o := &getAccountsOptions{ID: accountID, Limit: lopt}
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   202
	return mc.getMultipleAccountsHelper("followers", o)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   203
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   204
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   205
// GetAccountFollowing returns the list of accounts a given account is following
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   206
func (mc *Client) GetAccountFollowing(accountID int64, lopt *LimitParams) ([]Account, error) {
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   207
	o := &getAccountsOptions{ID: accountID, Limit: lopt}
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   208
	return mc.getMultipleAccountsHelper("following", o)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   209
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   210
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   211
// FollowAccount follows an account
218
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   212
// 'reblogs' can be used to specify if boots should be displayed or hidden.
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   213
func (mc *Client) FollowAccount(accountID int64, reblogs *bool) (*Relationship, error) {
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   214
	var params apiCallParams
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   215
	if reblogs != nil {
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   216
		params = make(apiCallParams)
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   217
		if *reblogs {
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   218
			params["reblogs"] = "true"
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   219
		} else {
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   220
			params["reblogs"] = "false"
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   221
		}
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   222
	}
22ed9de1c5fe FollowAccount: Add 'reblogs' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 207
diff changeset
   223
	rel, err := mc.updateRelationship("follow", accountID, params)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   224
	if err != nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   225
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   226
	}
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
   227
	if rel == nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   228
		return nil, ErrEntityNotFound
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   229
	}
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   230
	return rel, nil
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   231
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   232
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   233
// UnfollowAccount unfollows an account
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   234
func (mc *Client) UnfollowAccount(accountID int64) (*Relationship, error) {
205
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   235
	rel, err := mc.updateRelationship("unfollow", accountID, nil)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   236
	if err != nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   237
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   238
	}
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
   239
	if rel == nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   240
		return nil, ErrEntityNotFound
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   241
	}
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   242
	return rel, nil
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   243
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   244
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   245
// FollowRemoteAccount follows a remote account
193
f4ac09bc2964 Fix typo in comment
Mikael Berthe <mikael@lilotux.net>
parents: 184
diff changeset
   246
// The parameter 'uri' is a URI (e.g. "username@domain").
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 134
diff changeset
   247
func (mc *Client) FollowRemoteAccount(uri string) (*Account, error) {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   248
	if uri == "" {
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   249
		return nil, ErrInvalidID
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   250
	}
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   251
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   252
	params := make(apiCallParams)
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   253
	params["uri"] = uri
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   254
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   255
	var account Account
238
1c0042e76902 Do not use a global API version
Mikael Berthe <mikael@lilotux.net>
parents: 235
diff changeset
   256
	if err := mc.apiCall("v1/follows", rest.Post, params, nil, nil, &account); err != nil {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   257
		return nil, err
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   258
	}
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   259
	if account.ID == 0 {
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   260
		return nil, ErrEntityNotFound
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   261
	}
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   262
	return &account, nil
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   263
}
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   264
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   265
// BlockAccount blocks an account
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   266
func (mc *Client) BlockAccount(accountID int64) (*Relationship, error) {
205
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   267
	rel, err := mc.updateRelationship("block", accountID, nil)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   268
	if err != nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   269
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   270
	}
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
   271
	if rel == nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   272
		return nil, ErrEntityNotFound
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   273
	}
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   274
	return rel, nil
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   275
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   276
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   277
// UnblockAccount unblocks an account
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   278
func (mc *Client) UnblockAccount(accountID int64) (*Relationship, error) {
205
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   279
	rel, err := mc.updateRelationship("unblock", accountID, nil)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   280
	if err != nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   281
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   282
	}
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
   283
	if rel == nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   284
		return nil, ErrEntityNotFound
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   285
	}
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   286
	return rel, nil
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   287
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   288
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   289
// MuteAccount mutes an account
205
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   290
// Note that with current Mastodon API, muteNotifications defaults to true
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   291
// when it is not provided.
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   292
func (mc *Client) MuteAccount(accountID int64, muteNotifications *bool) (*Relationship, error) {
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   293
	var params apiCallParams
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   294
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   295
	if muteNotifications != nil {
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   296
		params = make(apiCallParams)
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   297
		if *muteNotifications {
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   298
			params["notifications"] = "true"
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   299
		} else {
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   300
			params["notifications"] = "false"
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   301
		}
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   302
	}
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   303
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   304
	rel, err := mc.updateRelationship("mute", accountID, params)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   305
	if err != nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   306
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   307
	}
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
   308
	if rel == nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   309
		return nil, ErrEntityNotFound
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   310
	}
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   311
	return rel, nil
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   312
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   313
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   314
// UnmuteAccount unmutes an account
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   315
func (mc *Client) UnmuteAccount(accountID int64) (*Relationship, error) {
205
b27e7d229fdd MuteAccount: Add muteNotifications parameter
Mikael Berthe <mikael@lilotux.net>
parents: 204
diff changeset
   316
	rel, err := mc.updateRelationship("unmute", accountID, nil)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   317
	if err != nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   318
		return nil, err
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   319
	}
183
cd5aa242c01f (un)follow/mute/block return a Relationship entity
Mikael Berthe <mikael@lilotux.net>
parents: 162
diff changeset
   320
	if rel == nil {
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   321
		return nil, ErrEntityNotFound
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   322
	}
184
546db8bb5867 Change prototypes and return Relationship entities
Mikael Berthe <mikael@lilotux.net>
parents: 183
diff changeset
   323
	return rel, nil
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   324
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   325
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   326
// SearchAccounts returns a list of accounts matching the query string
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   327
// The lopt parameter is optional (can be nil) or can be used to set a limit.
206
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
   328
func (mc *Client) SearchAccounts(query string, following bool, lopt *LimitParams) ([]Account, error) {
9197fdf25388 SearchAccounts: Add 'following' parameter
Mikael Berthe <mikael@lilotux.net>
parents: 205
diff changeset
   329
	o := &getAccountsOptions{Q: query, Limit: lopt, Following: following}
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   330
	return mc.getMultipleAccountsHelper("search", o)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   331
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   332
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   333
// GetBlockedAccounts returns the list of blocked accounts
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   334
// The lopt parameter is optional (can be nil).
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   335
func (mc *Client) GetBlockedAccounts(lopt *LimitParams) ([]Account, error) {
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   336
	o := &getAccountsOptions{Limit: lopt}
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   337
	return mc.getMultipleAccountsHelper("blocks", o)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   338
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   339
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   340
// GetMutedAccounts returns the list of muted accounts
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   341
// The lopt parameter is optional (can be nil).
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   342
func (mc *Client) GetMutedAccounts(lopt *LimitParams) ([]Account, error) {
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   343
	o := &getAccountsOptions{Limit: lopt}
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   344
	return mc.getMultipleAccountsHelper("mutes", o)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   345
}
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   346
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   347
// GetAccountFollowRequests returns the list of follow requests accounts
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   348
// The lopt parameter is optional (can be nil).
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 143
diff changeset
   349
func (mc *Client) GetAccountFollowRequests(lopt *LimitParams) ([]Account, error) {
152
d9e73e9df9c6 Fix unused limit options
Mikael Berthe <mikael@lilotux.net>
parents: 149
diff changeset
   350
	o := &getAccountsOptions{Limit: lopt}
161
6786f169b59f Refactor getMultipleAccounts
Mikael Berthe <mikael@lilotux.net>
parents: 160
diff changeset
   351
	return mc.getMultipleAccountsHelper("follow_requests", o)
109
37de1a30f465 Add account-related API calls
Mikael Berthe <mikael@lilotux.net>
parents: 8
diff changeset
   352
}
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   353
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   354
// GetAccountRelationships returns a list of relationship entities for the given accounts
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   355
func (mc *Client) GetAccountRelationships(accountIDs []int64) ([]Relationship, error) {
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   356
	if len(accountIDs) < 1 {
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   357
		return nil, ErrInvalidID
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   358
	}
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   359
125
2bbb72b9ebf6 Rework the API wrappers to handle arrays of parameters
Mikael Berthe <mikael@lilotux.net>
parents: 120
diff changeset
   360
	params := make(apiCallParams)
2bbb72b9ebf6 Rework the API wrappers to handle arrays of parameters
Mikael Berthe <mikael@lilotux.net>
parents: 120
diff changeset
   361
	for i, id := range accountIDs {
134
588edbc9e14b Add checks on ID list values
Mikael Berthe <mikael@lilotux.net>
parents: 132
diff changeset
   362
		if id < 1 {
588edbc9e14b Add checks on ID list values
Mikael Berthe <mikael@lilotux.net>
parents: 132
diff changeset
   363
			return nil, ErrInvalidID
588edbc9e14b Add checks on ID list values
Mikael Berthe <mikael@lilotux.net>
parents: 132
diff changeset
   364
		}
243
7386c6a454a8 Change the way parameter lists are handled internally
Mikael Berthe <mikael@lilotux.net>
parents: 242
diff changeset
   365
		qID := fmt.Sprintf("[%d]id", i)
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   366
		params[qID] = strconv.FormatInt(id, 10)
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   367
	}
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   368
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   369
	var rl []Relationship
238
1c0042e76902 Do not use a global API version
Mikael Berthe <mikael@lilotux.net>
parents: 235
diff changeset
   370
	if err := mc.apiCall("v1/accounts/relationships", rest.Get, params, nil, nil, &rl); err != nil {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   371
		return nil, err
111
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   372
	}
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   373
	return rl, nil
fc7cd6c90b2e Add FollowRemoteAccount() and GetAccountRelationships()
Mikael Berthe <mikael@lilotux.net>
parents: 110
diff changeset
   374
}
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   375
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   376
// GetAccountStatuses returns a list of status entities for the given account
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   377
// If onlyMedia is true, returns only statuses that have media attachments.
204
5cf1e0b45073 Add ability to retrieve pinned statuses only
Mikael Berthe <mikael@lilotux.net>
parents: 202
diff changeset
   378
// If onlyPinned is true, returns only statuses that have been pinned.
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   379
// If excludeReplies is true, skip statuses that reply to other statuses.
156
70aadba26338 Add field "All" to LimitParams, change Limit behaviour
Mikael Berthe <mikael@lilotux.net>
parents: 155
diff changeset
   380
// If lopt.All is true, several requests will be made until the API server
70aadba26338 Add field "All" to LimitParams, change Limit behaviour
Mikael Berthe <mikael@lilotux.net>
parents: 155
diff changeset
   381
// has nothing to return.
70aadba26338 Add field "All" to LimitParams, change Limit behaviour
Mikael Berthe <mikael@lilotux.net>
parents: 155
diff changeset
   382
// If lopt.Limit is set (and not All), several queries can be made until the
70aadba26338 Add field "All" to LimitParams, change Limit behaviour
Mikael Berthe <mikael@lilotux.net>
parents: 155
diff changeset
   383
// limit is reached.
204
5cf1e0b45073 Add ability to retrieve pinned statuses only
Mikael Berthe <mikael@lilotux.net>
parents: 202
diff changeset
   384
func (mc *Client) GetAccountStatuses(accountID int64, onlyPinned, onlyMedia, excludeReplies bool, lopt *LimitParams) ([]Status, error) {
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   385
	if accountID < 1 {
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   386
		return nil, ErrInvalidID
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   387
	}
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   388
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   389
	endPoint := "accounts/" + strconv.FormatInt(accountID, 10) + "/" + "statuses"
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   390
	params := make(apiCallParams)
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   391
	if onlyMedia {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   392
		params["only_media"] = "true"
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   393
	}
204
5cf1e0b45073 Add ability to retrieve pinned statuses only
Mikael Berthe <mikael@lilotux.net>
parents: 202
diff changeset
   394
	if onlyPinned {
5cf1e0b45073 Add ability to retrieve pinned statuses only
Mikael Berthe <mikael@lilotux.net>
parents: 202
diff changeset
   395
		params["pinned"] = "true"
5cf1e0b45073 Add ability to retrieve pinned statuses only
Mikael Berthe <mikael@lilotux.net>
parents: 202
diff changeset
   396
	}
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   397
	if excludeReplies {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 115
diff changeset
   398
		params["exclude_replies"] = "true"
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   399
	}
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   400
160
9f7e683b323f Refactor methods returning a list of statuses
Mikael Berthe <mikael@lilotux.net>
parents: 159
diff changeset
   401
	return mc.getMultipleStatuses(endPoint, params, lopt)
114
0a1f493588ee Add GetAccountStatuses()
Mikael Berthe <mikael@lilotux.net>
parents: 111
diff changeset
   402
}
115
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   403
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   404
// FollowRequestAuthorize authorizes or rejects an account follow-request
159
408aa794d9bb s/int/int64/ for IDs and time integers
Mikael Berthe <mikael@lilotux.net>
parents: 156
diff changeset
   405
func (mc *Client) FollowRequestAuthorize(accountID int64, authorize bool) error {
115
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   406
	endPoint := "follow_requests/reject"
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   407
	if authorize {
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   408
		endPoint = "follow_requests/authorize"
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   409
	}
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 134
diff changeset
   410
	_, err := mc.getSingleAccount(endPoint, accountID)
115
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   411
	return err
0684ac8b6634 Add FollowRequestAuthorize()
Mikael Berthe <mikael@lilotux.net>
parents: 114
diff changeset
   412
}
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   413
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   414
// UpdateAccount updates the connected user's account data
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   415
//
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   416
// The fields avatar & headerImage are considered as file paths
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   417
// and their content will be uploaded.
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   418
// Please note that currently Mastodon leaks the avatar file name:
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   419
// https://github.com/tootsuite/mastodon/issues/5776
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   420
//
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   421
// All fields can be nil, in which case they are not updated.
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   422
// 'DisplayName' and 'Note' can be set to "" to delete previous values.
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   423
// Setting 'Locked' to true means all followers should be approved.
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   424
// You can set 'Bot' to true to indicate this is a service (automated) account.
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   425
// I'm not sure images can be deleted -- only replaced AFAICS.
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   426
func (mc *Client) UpdateAccount(cmdParams UpdateAccountParams) (*Account, error) {
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   427
	const endPoint = "accounts/update_credentials"
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   428
	params := make(apiCallParams)
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   429
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   430
	if cmdParams.DisplayName != nil {
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   431
		params["display_name"] = *cmdParams.DisplayName
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   432
	}
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   433
	if cmdParams.Note != nil {
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   434
		params["note"] = *cmdParams.Note
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   435
	}
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   436
	if cmdParams.Locked != nil {
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   437
		if *cmdParams.Locked {
202
30bea35361cf Add 'locked' parameter to UpdateAccount
Mikael Berthe <mikael@lilotux.net>
parents: 193
diff changeset
   438
			params["locked"] = "true"
30bea35361cf Add 'locked' parameter to UpdateAccount
Mikael Berthe <mikael@lilotux.net>
parents: 193
diff changeset
   439
		} else {
30bea35361cf Add 'locked' parameter to UpdateAccount
Mikael Berthe <mikael@lilotux.net>
parents: 193
diff changeset
   440
			params["locked"] = "false"
30bea35361cf Add 'locked' parameter to UpdateAccount
Mikael Berthe <mikael@lilotux.net>
parents: 193
diff changeset
   441
		}
30bea35361cf Add 'locked' parameter to UpdateAccount
Mikael Berthe <mikael@lilotux.net>
parents: 193
diff changeset
   442
	}
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   443
	if cmdParams.Bot != nil {
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   444
		if *cmdParams.Bot {
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   445
			params["bot"] = "true"
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   446
		} else {
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   447
			params["bot"] = "false"
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   448
		}
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   449
	}
232
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   450
	if cmdParams.FieldsAttributes != nil {
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   451
		if len(*cmdParams.FieldsAttributes) > 4 {
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   452
			return nil, errors.New("too many fields (max=4)")
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   453
		}
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   454
		for i, attr := range *cmdParams.FieldsAttributes {
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   455
			qName := fmt.Sprintf("fields_attributes[%d][name]", i)
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   456
			qValue := fmt.Sprintf("fields_attributes[%d][value]", i)
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   457
			params[qName] = attr.Name
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   458
			params[qValue] = attr.Value
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   459
		}
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   460
	}
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   461
	if cmdParams.Source != nil {
242
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   462
		s := cmdParams.Source
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   463
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   464
		if s.Privacy != nil {
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   465
			params["source[privacy]"] = *s.Privacy
232
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   466
		}
242
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   467
		if s.Language != nil {
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   468
			params["source[language]"] = *s.Language
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   469
		}
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   470
		if s.Sensitive != nil {
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   471
			params["source[sensitive]"] = fmt.Sprintf("%v", *s.Sensitive)
2ec8b4cdf94e UpdateAccount: Change source data update parameters
Mikael Berthe <mikael@lilotux.net>
parents: 241
diff changeset
   472
		}
232
de13b1d39099 UpdateAccount: Add support for FieldsAttributes and Source parameters
Mikael Berthe <mikael@lilotux.net>
parents: 231
diff changeset
   473
	}
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   474
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   475
	var err error
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   476
	var avatar, headerImage []byte
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   477
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   478
	avatar, err = readFile(cmdParams.AvatarImagePath)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   479
	if err != nil {
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   480
		return nil, err
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   481
	}
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   482
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   483
	headerImage, err = readFile(cmdParams.HeaderImagePath)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   484
	if err != nil {
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   485
		return nil, err
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   486
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   487
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   488
	var formBuf bytes.Buffer
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   489
	w := multipart.NewWriter(&formBuf)
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   490
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   491
	if avatar != nil {
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   492
		formWriter, err := w.CreateFormFile("avatar", filepath.Base(*cmdParams.AvatarImagePath))
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   493
		if err != nil {
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   494
			return nil, errors.Wrap(err, "avatar upload")
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   495
		}
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   496
		formWriter.Write(avatar)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   497
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   498
	if headerImage != nil {
229
69f29aacd5bc Update UpdateAccount prototype; add "bot" parameter
Mikael Berthe <mikael@lilotux.net>
parents: 226
diff changeset
   499
		formWriter, err := w.CreateFormFile("header", filepath.Base(*cmdParams.HeaderImagePath))
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   500
		if err != nil {
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   501
			return nil, errors.Wrap(err, "header upload")
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   502
		}
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   503
		formWriter.Write(headerImage)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   504
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   505
	w.Close()
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   506
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   507
	// Prepare the request
241
8538eaf18ce5 Fix endpoint for update_credentials (broken by 9dcadf72)
Mikael Berthe <mikael@lilotux.net>
parents: 238
diff changeset
   508
	req, err := mc.prepareRequest("v1/"+endPoint, rest.Patch, params)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   509
	if err != nil {
162
68df3a01e1a7 Use github.com/pkg/errors
Mikael Berthe <mikael@lilotux.net>
parents: 161
diff changeset
   510
		return nil, errors.Wrap(err, "prepareRequest failed")
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   511
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   512
	req.Headers["Content-Type"] = w.FormDataContentType()
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   513
	req.Body = formBuf.Bytes()
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   514
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   515
	// Make API call
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   516
	r, err := restAPI(req)
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   517
	if err != nil {
162
68df3a01e1a7 Use github.com/pkg/errors
Mikael Berthe <mikael@lilotux.net>
parents: 161
diff changeset
   518
		return nil, errors.Wrap(err, "account update failed")
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   519
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   520
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   521
	// Check for error reply
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   522
	var errorResult Error
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   523
	if err := json.Unmarshal([]byte(r.Body), &errorResult); err == nil {
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   524
		// The empty object is not an error
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   525
		if errorResult.Text != "" {
162
68df3a01e1a7 Use github.com/pkg/errors
Mikael Berthe <mikael@lilotux.net>
parents: 161
diff changeset
   526
			return nil, errors.New(errorResult.Text)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   527
		}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   528
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   529
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   530
	// Not an error reply; let's unmarshal the data
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   531
	var account Account
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   532
	if err := json.Unmarshal([]byte(r.Body), &account); err != nil {
162
68df3a01e1a7 Use github.com/pkg/errors
Mikael Berthe <mikael@lilotux.net>
parents: 161
diff changeset
   533
		return nil, errors.Wrap(err, "cannot decode API response")
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   534
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   535
	return &account, nil
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   536
}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   537
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   538
// readFile is a helper function to read a file's contents.
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   539
func readFile(filename *string) ([]byte, error) {
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   540
	if filename == nil || *filename == "" {
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   541
		return nil, nil
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   542
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   543
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   544
	file, err := os.Open(*filename)
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   545
	if err != nil {
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   546
		return nil, err
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   547
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   548
	defer file.Close()
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   549
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   550
	fStat, err := file.Stat()
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   551
	if err != nil {
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   552
		return nil, err
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   553
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   554
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   555
	buffer := make([]byte, fStat.Size())
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   556
	_, err = file.Read(buffer)
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   557
	if err != nil {
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   558
		return nil, err
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   559
	}
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   560
226
212a0e74e719 Don't use base64 encoding for header & avatar uploads
Mikael Berthe <mikael@lilotux.net>
parents: 218
diff changeset
   561
	return buffer, nil
143
9ce9b39c851c Add UpdateAccount()
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
   562
}