notifications.go
author Mikael Berthe <mikael@lilotux.net>
Fri, 28 Apr 2017 15:43:11 +0200
changeset 149 5f922977d7c7
parent 148 ae2cbcf18b55
child 155 0c581e0108da
permissions -rw-r--r--
Add support for limits and paging ({since,max}_id) API parameters
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
130
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 120
diff changeset
     1
/*
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 120
diff changeset
     2
Copyright 2017 Mikael Berthe
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 120
diff changeset
     3
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 120
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: 120
diff changeset
     5
*/
c450bb73f59a Update credits
Mikael Berthe <mikael@lilotux.net>
parents: 120
diff changeset
     6
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 132
diff changeset
     7
package madon
95
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
     8
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
     9
import (
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    10
	"strconv"
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    11
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    12
	"github.com/sendgrid/rest"
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    13
)
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    14
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    15
// GetNotifications returns the list of the user's notifications
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 148
diff changeset
    16
func (mc *Client) GetNotifications(lopt *LimitParams) ([]Notification, error) {
95
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    17
	var notifications []Notification
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 148
diff changeset
    18
	if err := mc.apiCall("notifications", rest.Get, nil, lopt, &notifications); err != nil {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 102
diff changeset
    19
		return nil, err
95
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    20
	}
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    21
	return notifications, nil
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    22
}
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    23
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    24
// GetNotification returns a notification
102
187aa2a668a5 Update comment
Mikael Berthe <mikael@lilotux.net>
parents: 99
diff changeset
    25
// The returned notification can be nil if there is an error or if the
187aa2a668a5 Update comment
Mikael Berthe <mikael@lilotux.net>
parents: 99
diff changeset
    26
// requested notification does not exist.
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 132
diff changeset
    27
func (mc *Client) GetNotification(notificationID int) (*Notification, error) {
132
639bbcddb4fe Make identifiers less ambiguous
Mikael Berthe <mikael@lilotux.net>
parents: 130
diff changeset
    28
	if notificationID < 1 {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 102
diff changeset
    29
		return nil, ErrInvalidID
95
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    30
	}
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    31
132
639bbcddb4fe Make identifiers less ambiguous
Mikael Berthe <mikael@lilotux.net>
parents: 130
diff changeset
    32
	var endPoint = "notifications/" + strconv.Itoa(notificationID)
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 102
diff changeset
    33
	var notification Notification
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 148
diff changeset
    34
	if err := mc.apiCall(endPoint, rest.Get, nil, nil, &notification); err != nil {
120
579912e9d0ef Refactor API calls
Mikael Berthe <mikael@lilotux.net>
parents: 102
diff changeset
    35
		return nil, err
95
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    36
	}
99
6ec2a44a1bd1 Return error rather than empty entities
Mikael Berthe <mikael@lilotux.net>
parents: 98
diff changeset
    37
	if notification.ID == 0 {
6ec2a44a1bd1 Return error rather than empty entities
Mikael Berthe <mikael@lilotux.net>
parents: 98
diff changeset
    38
		return nil, ErrEntityNotFound
6ec2a44a1bd1 Return error rather than empty entities
Mikael Berthe <mikael@lilotux.net>
parents: 98
diff changeset
    39
	}
95
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    40
	return &notification, nil
94f139efff39 Add GetNotifications()
Mikael Berthe <mikael@lilotux.net>
parents:
diff changeset
    41
}
96
5496be0e3d4f Add ClearNotifications()
Mikael Berthe <mikael@lilotux.net>
parents: 95
diff changeset
    42
148
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    43
// DismissNotification deletes a notification
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    44
func (mc *Client) DismissNotification(notificationID int) error {
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    45
	if notificationID < 1 {
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    46
		return ErrInvalidID
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    47
	}
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    48
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    49
	endPoint := "notifications/dismiss"
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    50
	params := apiCallParams{"id": strconv.Itoa(notificationID)}
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 148
diff changeset
    51
	return mc.apiCall(endPoint, rest.Post, params, nil, &Notification{})
148
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    52
}
ae2cbcf18b55 Add DismissNotification (Mastodon 1.3+)
Mikael Berthe <mikael@lilotux.net>
parents: 138
diff changeset
    53
96
5496be0e3d4f Add ClearNotifications()
Mikael Berthe <mikael@lilotux.net>
parents: 95
diff changeset
    54
// ClearNotifications deletes all notifications from the Mastodon server for
5496be0e3d4f Add ClearNotifications()
Mikael Berthe <mikael@lilotux.net>
parents: 95
diff changeset
    55
// the authenticated user
138
23d3a518d0ad Update package name in source files
Mikael Berthe <mikael@lilotux.net>
parents: 132
diff changeset
    56
func (mc *Client) ClearNotifications() error {
149
5f922977d7c7 Add support for limits and paging ({since,max}_id) API parameters
Mikael Berthe <mikael@lilotux.net>
parents: 148
diff changeset
    57
	return mc.apiCall("notifications/clear", rest.Post, nil, nil, &Notification{})
96
5496be0e3d4f Add ClearNotifications()
Mikael Berthe <mikael@lilotux.net>
parents: 95
diff changeset
    58
}