Class: GdsApi::EmailAlertApi
- Defined in:
- lib/gds_api/email_alert_api.rb
Overview
Adapter for the Email Alert API
Instance Attribute Summary
Attributes inherited from Base
Instance Method Summary collapse
-
#change_subscriber(id:, new_address:) ⇒ Hash
Patch a Subscriber.
-
#change_subscription(id:, frequency:) ⇒ Hash
Patch a Subscription.
-
#create_auth_token(address:, destination:, redirect: nil) ⇒ Hash
Create an authentication token for a subscriber.
-
#create_subscriber_list(attributes) ⇒ Object
Post a subscriber list.
-
#find_or_create_subscriber_list(attributes) ⇒ Object
Get or Post subscriber list.
-
#find_subscriber_list(attributes) ⇒ Object
Get a subscriber list.
-
#get_subscribable(reference:) ⇒ Hash
Get a Subscribable.
-
#get_subscription(id) ⇒ Hash
Get a Subscription.
-
#get_subscriptions(id:) ⇒ Hash
Get Subscriptions for a Subscriber.
-
#send_alert(publication, headers = {}) ⇒ Object
Post notification.
-
#send_unpublish_message(message) ⇒ Object
Unpublishing alert.
-
#subscribe(subscribable_id:, address:, frequency: "immediately") ⇒ Hash
Subscribe.
-
#topic_matches(attributes) ⇒ Hash
Get topic matches.
-
#unsubscribe(uuid) ⇒ nil
Unsubscribe subscriber from subscription.
-
#unsubscribe_subscriber(id) ⇒ nil
Unsubscribe subscriber from everything.
Methods inherited from Base
#client, #create_client, #get_list, #initialize, #url_for_slug
Constructor Details
This class inherits a constructor from GdsApi::Base
Instance Method Details
#change_subscriber(id:, new_address:) ⇒ Hash
Patch a Subscriber
163 164 165 166 167 168 |
# File 'lib/gds_api/email_alert_api.rb', line 163 def change_subscriber(id:, new_address:) patch_json( "#{endpoint}/subscribers/#{id}", new_address: new_address ) end |
#change_subscription(id:, frequency:) ⇒ Hash
Patch a Subscription
176 177 178 179 180 181 |
# File 'lib/gds_api/email_alert_api.rb', line 176 def change_subscription(id:, frequency:) patch_json( "#{endpoint}/subscriptions/#{id}", frequency: frequency ) end |
#create_auth_token(address:, destination:, redirect: nil) ⇒ Hash
Create an authentication token for a subscriber
191 192 193 194 195 196 197 198 |
# File 'lib/gds_api/email_alert_api.rb', line 191 def create_auth_token(address:, destination:, redirect: nil) post_json( "#{endpoint}/subscribers/auth-token", address: address, destination: destination, redirect: redirect, ) end |
#create_subscriber_list(attributes) ⇒ Object
Post a subscriber list
49 50 51 |
# File 'lib/gds_api/email_alert_api.rb', line 49 def create_subscriber_list(attributes) post_json("#{endpoint}/subscriber-lists", attributes) end |
#find_or_create_subscriber_list(attributes) ⇒ Object
Get or Post subscriber list
12 13 14 15 16 |
# File 'lib/gds_api/email_alert_api.rb', line 12 def find_or_create_subscriber_list(attributes) find_subscriber_list(attributes) rescue GdsApi::HTTPNotFound create_subscriber_list(attributes) end |
#find_subscriber_list(attributes) ⇒ Object
Get a subscriber list
21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
# File 'lib/gds_api/email_alert_api.rb', line 21 def find_subscriber_list(attributes) = attributes["tags"] links = attributes["links"] document_type = attributes["document_type"] email_document_supertype = attributes["email_document_supertype"] government_document_supertype = attributes["government_document_supertype"] gov_delivery_id = attributes["gov_delivery_id"] if && links = "please provide either tags or links (or neither), but not both" raise ArgumentError, end params = {} params[:tags] = if params[:links] = links if links params[:document_type] = document_type if document_type params[:email_document_supertype] = email_document_supertype if email_document_supertype params[:government_document_supertype] = government_document_supertype if government_document_supertype params[:gov_delivery_id] = gov_delivery_id if gov_delivery_id query_string = nested_query_string(params) get_json("#{endpoint}/subscriber-lists?" + query_string) end |
#get_subscribable(reference:) ⇒ Hash
Get a Subscribable
}
127 128 129 |
# File 'lib/gds_api/email_alert_api.rb', line 127 def get_subscribable(reference:) get_json("#{endpoint}/subscribables/#{reference}") end |
#get_subscription(id) ⇒ Hash
Get a Subscription
}
144 145 146 |
# File 'lib/gds_api/email_alert_api.rb', line 144 def get_subscription(id) get_json("#{endpoint}/subscriptions/#{id}") end |
#get_subscriptions(id:) ⇒ Hash
Get Subscriptions for a Subscriber
153 154 155 |
# File 'lib/gds_api/email_alert_api.rb', line 153 def get_subscriptions(id:) get_json("#{endpoint}/subscribers/#{id}/subscriptions") end |
#send_alert(publication, headers = {}) ⇒ Object
Post notification
56 57 58 |
# File 'lib/gds_api/email_alert_api.rb', line 56 def send_alert(publication, headers = {}) post_json("#{endpoint}/notifications", publication, headers) end |
#send_unpublish_message(message) ⇒ Object
Unpublishing alert
Used by email-alert-service to send a message to email-alert-api when an unpublishing message is put on the Rabbitmq queue by publishing-api
67 68 69 |
# File 'lib/gds_api/email_alert_api.rb', line 67 def () post_json("#{endpoint}/unpublish-messages", ) end |
#subscribe(subscribable_id:, address:, frequency: "immediately") ⇒ Hash
Subscribe
103 104 105 106 107 108 109 110 |
# File 'lib/gds_api/email_alert_api.rb', line 103 def subscribe(subscribable_id:, address:, frequency: "immediately") post_json( "#{endpoint}/subscriptions", subscribable_id: subscribable_id, address: address, frequency: frequency, ) end |
#topic_matches(attributes) ⇒ Hash
Get topic matches
email_document_supertype, government_document_supertype
77 78 79 80 |
# File 'lib/gds_api/email_alert_api.rb', line 77 def topic_matches(attributes) query_string = nested_query_string(attributes) get_json("#{endpoint}/topic-matches.json?#{query_string}") end |
#unsubscribe(uuid) ⇒ nil
Unsubscribe subscriber from subscription
87 88 89 |
# File 'lib/gds_api/email_alert_api.rb', line 87 def unsubscribe(uuid) post_json("#{endpoint}/unsubscribe/#{uuid}") end |
#unsubscribe_subscriber(id) ⇒ nil
Unsubscribe subscriber from everything
96 97 98 |
# File 'lib/gds_api/email_alert_api.rb', line 96 def unsubscribe_subscriber(id) delete_json("#{endpoint}/subscribers/#{id}") end |