messagemedia_messages_sdk 2.0.3 → 3.0.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 61e2ba3f6e85744f467728c2beefb8e537d02034f0befc5a94fa345b7457c555
4
- data.tar.gz: 182b877e4085c64695af2c99e08a23bdc2b09ac451ba742377da066b231a2e13
3
+ metadata.gz: e6e8b817954f1d1d78c4f6ca192c9505988b6442a764a27213f55170a033cf5b
4
+ data.tar.gz: fc4d1d4ba28b720c2e5aec0b797ed8d2cae06dba823a8417d17cae4184c6c76d
5
5
  SHA512:
6
- metadata.gz: 3ab573657e6c8b188c5714fbdb81f1b09b5a7b7c4e10a428ae85e0d1e02600c0d217c81ebcfb7672437784c68adabd714faa788e60f0c6113951967e7de65c65
7
- data.tar.gz: 19d1aa935b8263329c1d602a67a19c8acbe19dc7a16e7d215d7d96a830132dd5b804cff1bc3fbc59f066014bb3c60485b1958f0f7b6330fbb150701a0c098fd3
6
+ metadata.gz: 9c4fdc179c468f371d525dad185f84b5cd263e3779f13fd26135c38a5c78c78959163d23891cf25a808814a4e5659d085848635785eae906083b83868c5def57
7
+ data.tar.gz: f0dc2523c98c69b2ee6cec1b56606d08156cef4a00e8722ba923537bd7b80772d92b264145dd18f5c98bb422a9c28da68527820b480103067cf852bfb701fe31
data/README.md CHANGED
@@ -1,294 +1,292 @@
1
-
2
- # MessageMedia Messages Ruby SDK
3
- [![Build Status](https://travis-ci.org/messagemedia/messages-ruby-sdk.svg?branch=master)](https://travis-ci.org/messagemedia/messages-ruby-sdk)
4
- [![Pull Requests Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat)](http://makeapullrequest.com)
5
- [![HitCount](http://hits.dwyl.io/messagemedia/messages-ruby-sdk.svg)](http://hits.dwyl.io/messagemedia/messages-ruby-sdk)
6
- [![gem](https://badge.fury.io/rb/messagemedia_messages_sdk.svg)](https://rubygems.org/gems/messagemedia_messages_sdk)
7
-
8
- The MessageMedia Messages API provides a number of endpoints for building powerful two-way messaging applications.
9
-
10
- ![Isometric](https://i.imgur.com/jJeHwf5.png)
11
-
12
- ## Table of Contents
13
- * [Authentication](#closed_lock_with_key-authentication)
14
- * [Errors](#interrobang-errors)
15
- * [Information](#newspaper-information)
16
- * [Slack and Mailing List](#slack-and-mailing-list)
17
- * [Bug Reports](#bug-reports)
18
- * [Contributing](#contributing)
19
- * [Installation](#star-installation)
20
- * [Get Started](#clapper-get-started)
21
- * [API Documentation](#closed_book-api-documentation)
22
- * [Need help?](#confused-need-help)
23
- * [License](#page_with_curl-license)
24
-
25
- ## :closed_lock_with_key: Authentication
26
-
27
- Authentication is done via API keys. Sign up at https://developers.messagemedia.com/register/ to get your API keys.
28
-
29
- Requests are authenticated using HTTP Basic Auth or HMAC. For Basic Auth, your API key will be basicAuthUserName and API secret will be basicAuthPassword. For HMAC, your API key will be hmacAuthUserName and API secret will be hmacAuthPassword. This is demonstrated in the [Send an SMS example](https://github.com/messagemedia/messages-ruby-sdk/blob/master/README.md#send-an-sms) below.
30
-
31
- ## :interrobang: Errors
32
-
33
- Our API returns standard HTTP success or error status codes. For errors, we will also include extra information about what went wrong encoded in the response as JSON. The most common status codes are listed below.
34
-
35
- #### HTTP Status Codes
36
-
37
- | Code | Title | Description |
38
- |-----------|-------------|-------------|
39
- | 400 | Invalid Request | The request was invalid |
40
- | 401 | Unauthorized | Your API credentials are invalid |
41
- | 403 | Disabled feature | Feature not enabled |
42
- | 404 | Not Found | The resource does not exist |
43
- | 50X | Internal Server Error | An error occurred with our API |
44
-
45
- ## :newspaper: Information
46
-
47
- #### Slack and Mailing List
48
-
49
- If you have any questions, comments, or concerns, please join our Slack channel:
50
- https://developers.messagemedia.com/collaborate/slack/
51
-
52
- Alternatively you can email us at:
53
- developers@messagemedia.com
54
-
55
- #### Bug reports
56
-
57
- If you discover a problem with the SDK, we would like to know about it. You can raise an [issue](https://github.com/messagemedia/signingkeys-nodejs-sdk/issues) or send an email to: developers@messagemedia.com
58
-
59
- #### Contributing
60
-
61
- We welcome your thoughts on how we could best provide you with SDKs that would simplify how you consume our services in your application. You can fork and create pull requests for any features you would like to see or raise an [issue](https://github.com/messagemedia/messages-nodejs-sdk/issues). Please be aware that a large share of the files are auto-generated by our backend tool.
62
-
63
- ## :star: Installation
64
- * Run the following command to install the SDK via RubyGems:
65
- ```
66
- gem install messagemedia_messages_sdk
67
- ```
68
-
69
- ## :clapper: Get Started
70
- It's easy to get started. Simply enter the API Key and secret you obtained from the [MessageMedia Developers Portal](https://developers.messagemedia.com) into the code snippet below and a mobile number you wish to send to.
71
-
72
- ### Send an SMS
73
- Destination (`destinationNumber`) and source number (`sourceNumber`) should be in the [E.164](http://en.wikipedia.org/wiki/E.164) format. For example, `+61491570156` NOT `0491570156`. The code snippet below comprises of only the bare minimum parameters required to send a message. You can view the full list of parameters over [here](https://github.com/messagemedia/messages-ruby-sdk/wiki/Message-Body-Parameters). Alternatively, you can refer [this](https://github.com/messagemedia/messages-ruby-sdk/blob/master/examples/sendMessage.rb) code snippet with all the parameters in use.
74
-
75
- ```ruby
76
- require 'message_media_messages'
77
- require 'pp'
78
-
79
- include MessageMediaMessages
80
-
81
- auth_user_name = 'API_KEY'
82
- auth_password = 'API_SECRET'
83
- use_hmac = false
84
-
85
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
86
- auth_user_name: auth_user_name,
87
- auth_password: auth_password,
88
- use_hmac_authentication: use_hmac
89
- )
90
-
91
- messages_controller = client.messages
92
- body = SendMessagesRequest.new
93
- body.messages = []
94
-
95
- body.messages[0] = Message.new
96
- body.messages[0].content = 'My first message'
97
- body.messages[0].destination_number = '+61491570156'
98
-
99
- begin
100
- result = messages_controller.send_messages(body)
101
- pp result
102
- rescue SendMessages400ResponseException => ex
103
- puts "Caught SendMessages400ResponseException: #{ex.message}"
104
- rescue APIException => ex
105
- puts "Caught APIException: #{ex.message}"
106
- end
107
- ```
108
-
109
- ## Send an MMS
110
- Destination (`destinationNumber`) and source number (`sourceNumber`) should be in the [E.164](http://en.wikipedia.org/wiki/E.164) format. For example, `+61491570156` NOT `0491570156`. The code snippet below comprises of only the bare minimum parameters required to send a message. You can view the full list of parameters over [here](https://github.com/messagemedia/messages-ruby-sdk/wiki/Message-Body-Parameters). Alternatively, you can refer [this](https://github.com/messagemedia/messages-ruby-sdk/blob/master/examples/sendMessage.rb) code snippet with all the parameters in use.
111
-
112
- ```ruby
113
- require 'message_media_messages'
114
- require 'pp'
115
-
116
- include MessageMediaMessages
117
-
118
- auth_user_name = 'API_KEY'
119
- auth_password = 'API_SECRET'
120
- use_hmac = false
121
-
122
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
123
- auth_user_name: auth_user_name,
124
- auth_password: auth_password,
125
- use_hmac_authentication: use_hmac
126
- )
127
-
128
- messages_controller = client.messages
129
- body = SendMessagesRequest.new
130
- body.messages = []
131
-
132
- body.messages[0] = Message.new
133
- body.messages[0].content = 'My second message'
134
- body.messages[0].destination_number = '+61491570158'
135
- body.messages[0].format = FormatEnum::MMS
136
- body.messages[0].media = ['https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg']
137
- body.messages[0].subject = 'This is an MMS message'
138
-
139
- begin
140
- result = messages_controller.send_messages(body)
141
- pp result
142
- rescue SendMessages400ResponseException => ex
143
- puts "Caught SendMessages400ResponseException: #{ex.message}"
144
- rescue APIException => ex
145
- puts "Caught APIException: #{ex.message}"
146
- end
147
- ```
148
-
149
- ### Get Status of a Message
150
- You can get a messsage ID from a sent message by looking at the `message_id` from the response of the above example.
151
- ```ruby
152
- require 'message_media_messages'
153
- require 'pp'
154
-
155
- include MessageMediaMessages
156
-
157
- auth_user_name = 'API_KEY'
158
- auth_password = 'API_SECRET'
159
- use_hmac = false
160
-
161
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
162
- auth_user_name: auth_user_name,
163
- auth_password: auth_password,
164
- use_hmac_authentication: use_hmac
165
- )
166
-
167
- messages_controller = client.messages
168
- message_id = '877c19ef-fa2e-4cec-827a-e1df9b5509f7'
169
-
170
- begin
171
- result = messages_controller.get_message_status(message_id)
172
- pp result
173
- rescue APIException => ex
174
- puts "Caught APIException: #{ex.message}"
175
- end
176
- ```
177
-
178
- ### Get replies to a message
179
- You can check for replies that are sent to your messages
180
- ```ruby
181
- require 'message_media_messages'
182
- require 'pp'
183
-
184
- include MessageMediaMessages
185
-
186
- auth_user_name = 'API_KEY'
187
- auth_password = 'API_SECRET'
188
- use_hmac = false
189
-
190
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
191
- auth_user_name: auth_user_name,
192
- auth_password: auth_password,
193
- use_hmac_authentication: use_hmac
194
- )
195
-
196
- replies_controller = client.replies
197
- begin
198
- result = replies_controller.check_replies()
199
- pp replies
200
- rescue APIException => ex
201
- puts "Caught APIException: #{ex.message}"
202
- end
203
- ```
204
-
205
- ### Check Delivery Reports
206
- This endpoint allows you to check for delivery reports to inbound and outbound messages.
207
- ```ruby
208
- require 'message_media_messages'
209
- require 'pp'
210
-
211
- auth_user_name = 'API_KEY'
212
- auth_password = 'API_SECRET'
213
- use_hmac = false
214
-
215
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
216
- auth_user_name: auth_user_name,
217
- auth_password: auth_password,
218
- use_hmac_authentication: use_hmac
219
- )
220
-
221
- delivery_reports_controller = client.delivery_reports
222
- begin
223
- result = delivery_reports_controller.check_delivery_reports()
224
- pp result
225
- rescue APIException => ex
226
- puts "Caught APIException: #{ex.message}"
227
- end
228
- ```
229
-
230
- ### Confirm Delivery Reports
231
- This endpoint allows you to mark delivery reports as confirmed so they're no longer returned by the Check Delivery Reports function.
232
- ```ruby
233
- require 'message_media_messages'
234
- require 'pp'
235
-
236
- include MessageMediaMessages
237
-
238
- auth_user_name = 'API_KEY'
239
- auth_password = 'API_SECRET'
240
- use_hmac = false
241
-
242
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
243
- auth_user_name: auth_user_name,
244
- auth_password: auth_password,
245
- use_hmac_authentication: use_hmac
246
- )
247
-
248
- delivery_reports_controller = client.delivery_reports
249
- body = ConfirmDeliveryReportsAsReceivedRequest.new
250
- body.delivery_report_ids = ['011dcead-6988-4ad6-a1c7-6b6c68ea628d', '3487b3fa-6586-4979-a233-2d1b095c7718', 'ba28e94b-c83d-4759-98e7-ff9c7edb87a1']
251
-
252
- begin
253
- result = delivery_reports_controller.confirm_delivery_reports_as_received(body)
254
- pp result
255
- rescue APIException => ex
256
- puts "Caught APIException: #{ex.message}"
257
- end
258
- ```
259
-
260
- ### Check credits remaining (Prepaid accounts only)
261
- This endpoint allows you to check for credits remaining on your prepaid account.
262
- ```ruby
263
- require 'message_media_messages'
264
- require 'pp'
265
-
266
- include MessageMediaMessages
267
-
268
- auth_user_name = 'API_KEY'
269
- auth_password = 'API_SECRET'
270
- use_hmac = false
271
-
272
- client = MessageMediaMessages::MessageMediaMessagesClient.new(
273
- auth_user_name: auth_user_name,
274
- auth_password: auth_password,
275
- use_hmac_authentication: use_hmac
276
- )
277
-
278
- messages_controller = client.messages
279
- begin
280
- result = messages_controller.check_credits_remaining()
281
- pp result
282
- rescue APIException => ex
283
- puts "Caught APIException: #{ex.message}"
284
- end
285
- ```
286
-
287
- ## :closed_book: API Reference Documentation
288
- Check out the [full API documentation](https://developers.messagemedia.com/code/messages-api-documentation/) for more detailed information.
289
-
290
- ## :confused: Need help?
291
- Please contact developer support at developers@messagemedia.com or check out the developer portal at [developers.messagemedia.com](https://developers.messagemedia.com/)
292
-
293
- ## :page_with_curl: License
294
- Apache License. See the [LICENSE](LICENSE) file.
1
+
2
+ # MessageMedia Messages Ruby SDK
3
+ [![Build Status](https://github.com/messagemedia/messages-ruby-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/messagemedia/messages-ruby-sdk/actions/workflows/ci.yml)
4
+ [![gem](https://badge.fury.io/rb/messagemedia_messages_sdk.svg)](https://rubygems.org/gems/messagemedia_messages_sdk)
5
+
6
+ The MessageMedia Messages API provides a number of endpoints for building powerful two-way messaging applications.
7
+
8
+ ![Isometric](https://i.imgur.com/jJeHwf5.png)
9
+
10
+ ## Table of Contents
11
+ * [Authentication](#closed_lock_with_key-authentication)
12
+ * [Errors](#interrobang-errors)
13
+ * [Information](#newspaper-information)
14
+ * [Slack and Mailing List](#slack-and-mailing-list)
15
+ * [Bug Reports](#bug-reports)
16
+ * [Contributing](#contributing)
17
+ * [Installation](#star-installation)
18
+ * [Get Started](#clapper-get-started)
19
+ * [API Documentation](#closed_book-api-documentation)
20
+ * [Need help?](#confused-need-help)
21
+ * [License](#page_with_curl-license)
22
+
23
+ ## :closed_lock_with_key: Authentication
24
+
25
+ Authentication is done via API keys. Sign up at https://developers.messagemedia.com/register/ to get your API keys.
26
+
27
+ Requests are authenticated using HTTP Basic Auth or HMAC. For Basic Auth, your API key will be basicAuthUserName and API secret will be basicAuthPassword. For HMAC, your API key will be hmacAuthUserName and API secret will be hmacAuthPassword. This is demonstrated in the [Send an SMS example](https://github.com/messagemedia/messages-ruby-sdk/blob/master/README.md#send-an-sms) below.
28
+
29
+ ## :interrobang: Errors
30
+
31
+ Our API returns standard HTTP success or error status codes. For errors, we will also include extra information about what went wrong encoded in the response as JSON. The most common status codes are listed below.
32
+
33
+ #### HTTP Status Codes
34
+
35
+ | Code | Title | Description |
36
+ |-----------|-------------|-------------|
37
+ | 400 | Invalid Request | The request was invalid |
38
+ | 401 | Unauthorized | Your API credentials are invalid |
39
+ | 403 | Disabled feature | Feature not enabled |
40
+ | 404 | Not Found | The resource does not exist |
41
+ | 50X | Internal Server Error | An error occurred with our API |
42
+
43
+ ## :newspaper: Information
44
+
45
+ #### Slack and Mailing List
46
+
47
+ If you have any questions, comments, or concerns, please join our Slack channel:
48
+ https://developers.messagemedia.com/collaborate/slack/
49
+
50
+ Alternatively you can email us at:
51
+ developers@messagemedia.com
52
+
53
+ #### Bug reports
54
+
55
+ If you discover a problem with the SDK, we would like to know about it. You can raise an [issue](https://github.com/messagemedia/signingkeys-nodejs-sdk/issues) or send an email to: developers@messagemedia.com
56
+
57
+ #### Contributing
58
+
59
+ We welcome your thoughts on how we could best provide you with SDKs that would simplify how you consume our services in your application. You can fork and create pull requests for any features you would like to see or raise an [issue](https://github.com/messagemedia/messages-nodejs-sdk/issues). Please be aware that a large share of the files are auto-generated by our backend tool.
60
+
61
+ ## :star: Installation
62
+ * Run the following command to install the SDK via RubyGems:
63
+ ```
64
+ gem install messages-ruby-sdk --version "3.0.0" --source "https://rubygems.pkg.github.com/messagemedia"
65
+ ```
66
+
67
+ ## :clapper: Get Started
68
+ It's easy to get started. Simply enter the API Key and secret you obtained from the [MessageMedia Developers Portal](https://developers.messagemedia.com) into the code snippet below and a mobile number you wish to send to.
69
+
70
+ ### Send an SMS
71
+ Destination (`destinationNumber`) and source number (`sourceNumber`) should be in the [E.164](http://en.wikipedia.org/wiki/E.164) format. For example, `+61491570156` NOT `0491570156`. The code snippet below comprises of only the bare minimum parameters required to send a message. You can view the full list of parameters over [here](https://github.com/messagemedia/messages-ruby-sdk/wiki/Message-Body-Parameters). Alternatively, you can refer [this](https://github.com/messagemedia/messages-ruby-sdk/blob/master/examples/sendMessage.rb) code snippet with all the parameters in use.
72
+
73
+ ```ruby
74
+ require 'message_media_messages'
75
+ require 'pp'
76
+
77
+ include MessageMediaMessages
78
+
79
+ auth_user_name = 'API_KEY'
80
+ auth_password = 'API_SECRET'
81
+ use_hmac = false
82
+
83
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
84
+ auth_user_name: auth_user_name,
85
+ auth_password: auth_password,
86
+ use_hmac_authentication: use_hmac
87
+ )
88
+
89
+ messages_controller = client.messages
90
+ body = SendMessagesRequest.new
91
+ body.messages = []
92
+
93
+ body.messages[0] = Message.new
94
+ body.messages[0].content = 'My first message'
95
+ body.messages[0].destination_number = '+61491570156'
96
+
97
+ begin
98
+ result = messages_controller.send_messages(body)
99
+ pp result
100
+ rescue SendMessages400ResponseException => ex
101
+ puts "Caught SendMessages400ResponseException: #{ex.message}"
102
+ rescue APIException => ex
103
+ puts "Caught APIException: #{ex.message}"
104
+ end
105
+ ```
106
+
107
+ ## Send an MMS
108
+ Destination (`destinationNumber`) and source number (`sourceNumber`) should be in the [E.164](http://en.wikipedia.org/wiki/E.164) format. For example, `+61491570156` NOT `0491570156`. The code snippet below comprises of only the bare minimum parameters required to send a message. You can view the full list of parameters over [here](https://github.com/messagemedia/messages-ruby-sdk/wiki/Message-Body-Parameters). Alternatively, you can refer [this](https://github.com/messagemedia/messages-ruby-sdk/blob/master/examples/sendMessage.rb) code snippet with all the parameters in use.
109
+
110
+ ```ruby
111
+ require 'message_media_messages'
112
+ require 'pp'
113
+
114
+ include MessageMediaMessages
115
+
116
+ auth_user_name = 'API_KEY'
117
+ auth_password = 'API_SECRET'
118
+ use_hmac = false
119
+
120
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
121
+ auth_user_name: auth_user_name,
122
+ auth_password: auth_password,
123
+ use_hmac_authentication: use_hmac
124
+ )
125
+
126
+ messages_controller = client.messages
127
+ body = SendMessagesRequest.new
128
+ body.messages = []
129
+
130
+ body.messages[0] = Message.new
131
+ body.messages[0].content = 'My second message'
132
+ body.messages[0].destination_number = '+61491570158'
133
+ body.messages[0].format = FormatEnum::MMS
134
+ body.messages[0].media = ['https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg']
135
+ body.messages[0].subject = 'This is an MMS message'
136
+
137
+ begin
138
+ result = messages_controller.send_messages(body)
139
+ pp result
140
+ rescue SendMessages400ResponseException => ex
141
+ puts "Caught SendMessages400ResponseException: #{ex.message}"
142
+ rescue APIException => ex
143
+ puts "Caught APIException: #{ex.message}"
144
+ end
145
+ ```
146
+
147
+ ### Get Status of a Message
148
+ You can get a messsage ID from a sent message by looking at the `message_id` from the response of the above example.
149
+ ```ruby
150
+ require 'message_media_messages'
151
+ require 'pp'
152
+
153
+ include MessageMediaMessages
154
+
155
+ auth_user_name = 'API_KEY'
156
+ auth_password = 'API_SECRET'
157
+ use_hmac = false
158
+
159
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
160
+ auth_user_name: auth_user_name,
161
+ auth_password: auth_password,
162
+ use_hmac_authentication: use_hmac
163
+ )
164
+
165
+ messages_controller = client.messages
166
+ message_id = '877c19ef-fa2e-4cec-827a-e1df9b5509f7'
167
+
168
+ begin
169
+ result = messages_controller.get_message_status(message_id)
170
+ pp result
171
+ rescue APIException => ex
172
+ puts "Caught APIException: #{ex.message}"
173
+ end
174
+ ```
175
+
176
+ ### Get replies to a message
177
+ You can check for replies that are sent to your messages
178
+ ```ruby
179
+ require 'message_media_messages'
180
+ require 'pp'
181
+
182
+ include MessageMediaMessages
183
+
184
+ auth_user_name = 'API_KEY'
185
+ auth_password = 'API_SECRET'
186
+ use_hmac = false
187
+
188
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
189
+ auth_user_name: auth_user_name,
190
+ auth_password: auth_password,
191
+ use_hmac_authentication: use_hmac
192
+ )
193
+
194
+ replies_controller = client.replies
195
+ begin
196
+ result = replies_controller.check_replies()
197
+ pp replies
198
+ rescue APIException => ex
199
+ puts "Caught APIException: #{ex.message}"
200
+ end
201
+ ```
202
+
203
+ ### Check Delivery Reports
204
+ This endpoint allows you to check for delivery reports to inbound and outbound messages.
205
+ ```ruby
206
+ require 'message_media_messages'
207
+ require 'pp'
208
+
209
+ auth_user_name = 'API_KEY'
210
+ auth_password = 'API_SECRET'
211
+ use_hmac = false
212
+
213
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
214
+ auth_user_name: auth_user_name,
215
+ auth_password: auth_password,
216
+ use_hmac_authentication: use_hmac
217
+ )
218
+
219
+ delivery_reports_controller = client.delivery_reports
220
+ begin
221
+ result = delivery_reports_controller.check_delivery_reports()
222
+ pp result
223
+ rescue APIException => ex
224
+ puts "Caught APIException: #{ex.message}"
225
+ end
226
+ ```
227
+
228
+ ### Confirm Delivery Reports
229
+ This endpoint allows you to mark delivery reports as confirmed so they're no longer returned by the Check Delivery Reports function.
230
+ ```ruby
231
+ require 'message_media_messages'
232
+ require 'pp'
233
+
234
+ include MessageMediaMessages
235
+
236
+ auth_user_name = 'API_KEY'
237
+ auth_password = 'API_SECRET'
238
+ use_hmac = false
239
+
240
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
241
+ auth_user_name: auth_user_name,
242
+ auth_password: auth_password,
243
+ use_hmac_authentication: use_hmac
244
+ )
245
+
246
+ delivery_reports_controller = client.delivery_reports
247
+ body = ConfirmDeliveryReportsAsReceivedRequest.new
248
+ body.delivery_report_ids = ['011dcead-6988-4ad6-a1c7-6b6c68ea628d', '3487b3fa-6586-4979-a233-2d1b095c7718', 'ba28e94b-c83d-4759-98e7-ff9c7edb87a1']
249
+
250
+ begin
251
+ result = delivery_reports_controller.confirm_delivery_reports_as_received(body)
252
+ pp result
253
+ rescue APIException => ex
254
+ puts "Caught APIException: #{ex.message}"
255
+ end
256
+ ```
257
+
258
+ ### Check credits remaining (Prepaid accounts only)
259
+ This endpoint allows you to check for credits remaining on your prepaid account.
260
+ ```ruby
261
+ require 'message_media_messages'
262
+ require 'pp'
263
+
264
+ include MessageMediaMessages
265
+
266
+ auth_user_name = 'API_KEY'
267
+ auth_password = 'API_SECRET'
268
+ use_hmac = false
269
+
270
+ client = MessageMediaMessages::MessageMediaMessagesClient.new(
271
+ auth_user_name: auth_user_name,
272
+ auth_password: auth_password,
273
+ use_hmac_authentication: use_hmac
274
+ )
275
+
276
+ messages_controller = client.messages
277
+ begin
278
+ result = messages_controller.check_credits_remaining()
279
+ pp result
280
+ rescue APIException => ex
281
+ puts "Caught APIException: #{ex.message}"
282
+ end
283
+ ```
284
+
285
+ ## :closed_book: API Reference Documentation
286
+ Check out the [full API documentation](https://developers.messagemedia.com/code/messages-api-documentation/) for more detailed information.
287
+
288
+ ## :confused: Need help?
289
+ Please contact developer support at developers@messagemedia.com or check out the developer portal at [developers.messagemedia.com](https://developers.messagemedia.com/)
290
+
291
+ ## :page_with_curl: License
292
+ Apache License. See the [LICENSE](LICENSE) file.