sendgrid-ruby 3.0.5 → 3.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f9e089f11c9fcefbb345b5031cb7319a423c31c5
-  data.tar.gz: bbdce0d5b46c388c7e31c383531a2d026e800d3a
+  metadata.gz: d87e0ebd7948408c1716659ae622d2be7f95f59a
+  data.tar.gz: bc8f0d2d86daa5fea84161a044aac3f0960825cf
 SHA512:
-  metadata.gz: 9120ecc8f69f5b16f05ebf7a6302594063f80c13be13b44bb8fd08e7563baed25fa050af579db1b0f8a06f3c836f1ca9c631e5b3b0da998448aae2756a5bae93
-  data.tar.gz: 607643666e9f63e9f0d46f9e50c348da837c330d01645db804fc6cdde24b93a8580d506f2e232f9df690da5d885de5c4f18685e6d40a8c4414002bf209037787
+  metadata.gz: dd419b14d5b9b113b7860a4dc0683c70cb051dfa6494d225b28c6998b12b1dc025ab3fc53dce71a962044dc8dce15d23b815b4d3ec503d9f6d35d0978a9ccb64
+  data.tar.gz: e651ea89308ba59e482cd6fdc26058a3638a9ff0cc692daa294f2078c53e0c01040fd9d75a1c874c86fda2dcc4151dd29aeac8c99227c363de19ac56c8372b8d

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+## [3.0.6] - 2016-07-05 ##
+### Added
+- Update docs, unit tests and examples to include Sender ID
+
 ## [3.0.5] - 2016-07-05 ##
 ### Added
 - Accept: application/json header per https://sendgrid.com/docs/API_Reference/Web_API_v3/How_To_Use_The_Web_API_v3/requests.html

data/USAGE.md

@@ -28,6 +28,7 @@ sg = SendGrid::API.new(api_key: ENV['SENDGRID_API_KEY'])
 * [MAILBOX PROVIDERS](#mailbox_providers)
 * [PARTNER SETTINGS](#partner_settings)
 * [SCOPES](#scopes)
+* [SENDERS](#senders)
 * [STATS](#stats)
 * [SUBUSERS](#subusers)
 * [SUPPRESSION](#suppression)
@@ -1469,7 +1470,7 @@ The contactdb is a database of your contacts for [SendGrid Marketing Campaigns](
 
 
 ```ruby
-params = JSON.parse('{"%7Bfield_name%7D": "test_string", "{field_name}": "test_string"}')
+params = JSON.parse('{"{field_name}": "test_string"}')
 response = sg.client.contactdb.recipients.search.get(query_params: params)
 puts response.status_code
 puts response.body
@@ -2698,6 +2699,141 @@ puts response.status_code
 puts response.body
 puts response.headers
 ```
+<a name="senders"></a>
+# SENDERS
+
+## Create a Sender Identity
+
+**This endpoint allows you to create a new sender identity.**
+
+*You may create up to 100 unique sender identities.*
+
+Sender Identities are required to be verified before use. If your domain has been whitelabeled it will auto verify on creation. Otherwise an email will be sent to the `from.email`.
+
+### POST /senders
+
+
+```ruby
+data = JSON.parse('{
+  "address": "123 Elm St.",
+  "address_2": "Apt. 456",
+  "city": "Denver",
+  "country": "United States",
+  "from": {
+    "email": "from@example.com",
+    "name": "Example INC"
+  },
+  "nickname": "My Sender ID",
+  "reply_to": {
+    "email": "replyto@example.com",
+    "name": "Example INC"
+  },
+  "state": "Colorado",
+  "zip": "80202"
+}')
+response = sg.client.senders.post(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+```
+## Get all Sender Identities
+
+**This endpoint allows you to retrieve a list of all sender identities that have been created for your account.**
+
+Sender Identities are required to be verified before use. If your domain has been whitelabeled it will auto verify on creation. Otherwise an email will be sent to the `from.email`.
+
+### GET /senders
+
+
+```ruby
+response = sg.client.senders.get()
+puts response.status_code
+puts response.body
+puts response.headers
+```
+## Update a Sender Identity
+
+**This endpoint allows you to update a sender identity.**
+
+Updates to `from.email` require re-verification. If your domain has been whitelabeled it will auto verify on creation. Otherwise an email will be sent to the `from.email`.
+
+Partial updates are allowed, but fields that are marked as "required" in the POST (create) endpoint must not be nil if that field is included in the PATCH request.
+
+### PATCH /senders/{sender_id}
+
+
+```ruby
+data = JSON.parse('{
+  "address": "123 Elm St.",
+  "address_2": "Apt. 456",
+  "city": "Denver",
+  "country": "United States",
+  "from": {
+    "email": "from@example.com",
+    "name": "Example INC"
+  },
+  "nickname": "My Sender ID",
+  "reply_to": {
+    "email": "replyto@example.com",
+    "name": "Example INC"
+  },
+  "state": "Colorado",
+  "zip": "80202"
+}')
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+```
+## View a Sender Identity
+
+**This endpoint allows you to retrieve a specific sender identity.**
+
+Sender Identities are required to be verified before use. If your domain has been whitelabeled it will auto verify on creation. Otherwise an email will be sent to the `from.email`.
+
+### GET /senders/{sender_id}
+
+
+```ruby
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).get()
+puts response.status_code
+puts response.body
+puts response.headers
+```
+## Delete a Sender Identity
+
+**This endoint allows you to delete one of your sender identities.**
+
+Sender Identities are required to be verified before use. If your domain has been whitelabeled it will auto verify on creation. Otherwise an email will be sent to the `from.email`.
+
+### DELETE /senders/{sender_id}
+
+
+```ruby
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).delete()
+puts response.status_code
+puts response.body
+puts response.headers
+```
+## Resend Sender Identity Verification
+
+**This enpdoint allows you to resend a sender identity verification email.**
+
+Sender Identities are required to be verified before use. If your domain has been whitelabeled it will auto verify on creation. Otherwise an email will be sent to the `from.email`.
+
+### POST /senders/{sender_id}/resend_verification
+
+
+```ruby
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).resend_verification.post()
+puts response.status_code
+puts response.body
+puts response.headers
+```
 <a name="stats"></a>
 # STATS
 

data/examples/contactdb/contactdb.rb

@@ -240,7 +240,7 @@ puts response.headers
 # Retrieve recipients matching search criteria #
 # GET /contactdb/recipients/search #
 
-params = JSON.parse('{"%7Bfield_name%7D": "test_string", "{field_name}": "test_string"}')
+params = JSON.parse('{"{field_name}": "test_string"}')
 response = sg.client.contactdb.recipients.search.get(query_params: params)
 puts response.status_code
 puts response.body

data/examples/senders/senders.rb

@@ -0,0 +1,98 @@
+require 'sendgrid-ruby'
+
+
+sg = SendGrid::API.new(api_key: ENV['SENDGRID_API_KEY'])
+
+
+##################################################
+# Create a Sender Identity #
+# POST /senders #
+
+data = JSON.parse('{
+  "address": "123 Elm St.", 
+  "address_2": "Apt. 456", 
+  "city": "Denver", 
+  "country": "United States", 
+  "from": {
+    "email": "from@example.com", 
+    "name": "Example INC"
+  }, 
+  "nickname": "My Sender ID", 
+  "reply_to": {
+    "email": "replyto@example.com", 
+    "name": "Example INC"
+  }, 
+  "state": "Colorado", 
+  "zip": "80202"
+}')
+response = sg.client.senders.post(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Get all Sender Identities #
+# GET /senders #
+
+response = sg.client.senders.get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Update a Sender Identity #
+# PATCH /senders/{sender_id} #
+
+data = JSON.parse('{
+  "address": "123 Elm St.", 
+  "address_2": "Apt. 456", 
+  "city": "Denver", 
+  "country": "United States", 
+  "from": {
+    "email": "from@example.com", 
+    "name": "Example INC"
+  }, 
+  "nickname": "My Sender ID", 
+  "reply_to": {
+    "email": "replyto@example.com", 
+    "name": "Example INC"
+  }, 
+  "state": "Colorado", 
+  "zip": "80202"
+}')
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).patch(request_body: data)
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# View a Sender Identity #
+# GET /senders/{sender_id} #
+
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).get()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Delete a Sender Identity #
+# DELETE /senders/{sender_id} #
+
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).delete()
+puts response.status_code
+puts response.body
+puts response.headers
+
+##################################################
+# Resend Sender Identity Verification #
+# POST /senders/{sender_id}/resend_verification #
+
+sender_id = "test_url_param"
+response = sg.client.senders._(sender_id).resend_verification.post()
+puts response.status_code
+puts response.body
+puts response.headers
+

data/lib/sendgrid/version.rb

@@ -1,3 +1,3 @@
 module SendGrid
-  VERSION = '3.0.5'
+  VERSION = '3.0.6'
 end

data/test/sendgrid/test_sendgrid-ruby.rb

@@ -30,7 +30,7 @@ class TestAPI < Minitest::Test
             ')
         assert_equal(test_headers, sg.request_headers)
         assert_equal("v3", sg.version)
-        assert_equal("3.0.5", SendGrid::VERSION)
+        assert_equal("3.0.6", SendGrid::VERSION)
         assert_instance_of(SendGrid::Client, sg.client)
     end
 
@@ -659,7 +659,7 @@ class TestAPI < Minitest::Test
     end
 
     def test_contactdb_recipients_search_get
-        params = JSON.parse('{"%7Bfield_name%7D": "test_string", "{field_name}": "test_string"}')
+        params = JSON.parse('{"{field_name}": "test_string"}')
         headers = JSON.parse('{"X-Mock": 200}')
         response = @sg.client.contactdb.recipients.search.get(query_params: params, request_headers: headers)
         self.assert_equal(response.status_code, "200")
@@ -1242,6 +1242,80 @@ class TestAPI < Minitest::Test
         self.assert_equal(response.status_code, "200")
     end
 
+    def test_senders_post
+        data = JSON.parse('{
+  "address": "123 Elm St.",
+  "address_2": "Apt. 456",
+  "city": "Denver",
+  "country": "United States",
+  "from": {
+    "email": "from@example.com",
+    "name": "Example INC"
+  },
+  "nickname": "My Sender ID",
+  "reply_to": {
+    "email": "replyto@example.com",
+    "name": "Example INC"
+  },
+  "state": "Colorado",
+  "zip": "80202"
+}')
+        headers = JSON.parse('{"X-Mock": 201}')
+        response = @sg.client.senders.post(request_body: data, request_headers: headers)
+        self.assert_equal(response.status_code, "201")
+    end
+
+    def test_senders_get
+        headers = JSON.parse('{"X-Mock": 200}')
+        response = @sg.client.senders.get(request_headers: headers)
+        self.assert_equal(response.status_code, "200")
+    end
+
+    def test_senders__sender_id__patch
+        data = JSON.parse('{
+  "address": "123 Elm St.",
+  "address_2": "Apt. 456",
+  "city": "Denver",
+  "country": "United States",
+  "from": {
+    "email": "from@example.com",
+    "name": "Example INC"
+  },
+  "nickname": "My Sender ID",
+  "reply_to": {
+    "email": "replyto@example.com",
+    "name": "Example INC"
+  },
+  "state": "Colorado",
+  "zip": "80202"
+}')
+        sender_id = "test_url_param"
+        headers = JSON.parse('{"X-Mock": 200}')
+        response = @sg.client.senders._(sender_id).patch(request_body: data, request_headers: headers)
+        self.assert_equal(response.status_code, "200")
+    end
+
+    def test_senders__sender_id__get
+        sender_id = "test_url_param"
+        headers = JSON.parse('{"X-Mock": 200}')
+        response = @sg.client.senders._(sender_id).get(request_headers: headers)
+        self.assert_equal(response.status_code, "200")
+    end
+
+    def test_senders__sender_id__delete
+        sender_id = "test_url_param"
+        headers = JSON.parse('{"X-Mock": 204}')
+        response = @sg.client.senders._(sender_id).delete(request_headers: headers)
+        self.assert_equal(response.status_code, "204")
+    end
+
+    def test_senders__sender_id__resend_verification_post
+        sender_id = "test_url_param"
+        headers = JSON.parse('{"X-Mock": 204}')
+        response = @sg.client.senders._(sender_id).resend_verification.post(request_headers: headers)
+        self.assert_equal(response.status_code, "204")
+    end
+
     def test_stats_get
         params = JSON.parse('{"aggregated_by": "day", "limit": 1, "start_date": "2016-01-01", "end_date": "2016-04-01", "offset": 1}')
         headers = JSON.parse('{"X-Mock": 200}')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sendgrid-ruby
 version: !ruby/object:Gem::Version
-  version: 3.0.5
+  version: 3.0.6
 platform: ruby
 authors:
 - Elmer Thomas
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-05 00:00:00.000000000 Z
+date: 2016-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_http_client
@@ -74,6 +74,7 @@ files:
 - examples/mailsettings/mailsettings.rb
 - examples/partnersettings/partnersettings.rb
 - examples/scopes/scopes.rb
+- examples/senders/senders.rb
 - examples/stats/stats.rb
 - examples/subusers/subusers.rb
 - examples/suppression/suppression.rb