telnyx 0.0.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gitattributes +4 -0
- data/.github/ISSUE_TEMPLATE.md +5 -0
- data/.gitignore +9 -0
- data/.rubocop.yml +32 -0
- data/.rubocop_todo.yml +50 -0
- data/.travis.yml +42 -0
- data/CHANGELOG.md +2 -0
- data/CONTRIBUTORS +0 -0
- data/Gemfile +40 -0
- data/Guardfile +8 -0
- data/LICENSE +22 -0
- data/README.md +173 -0
- data/Rakefile +28 -0
- data/VERSION +1 -0
- data/bin/telnyx-console +16 -0
- data/lib/telnyx.rb +151 -0
- data/lib/telnyx/api_operations/create.rb +12 -0
- data/lib/telnyx/api_operations/delete.rb +13 -0
- data/lib/telnyx/api_operations/list.rb +29 -0
- data/lib/telnyx/api_operations/nested_resource.rb +63 -0
- data/lib/telnyx/api_operations/request.rb +57 -0
- data/lib/telnyx/api_operations/save.rb +103 -0
- data/lib/telnyx/api_resource.rb +69 -0
- data/lib/telnyx/available_phone_number.rb +9 -0
- data/lib/telnyx/errors.rb +166 -0
- data/lib/telnyx/event.rb +9 -0
- data/lib/telnyx/list_object.rb +155 -0
- data/lib/telnyx/message.rb +9 -0
- data/lib/telnyx/messaging_phone_number.rb +10 -0
- data/lib/telnyx/messaging_profile.rb +32 -0
- data/lib/telnyx/messaging_sender_id.rb +12 -0
- data/lib/telnyx/messaging_short_code.rb +10 -0
- data/lib/telnyx/number_order.rb +11 -0
- data/lib/telnyx/number_reservation.rb +11 -0
- data/lib/telnyx/public_key.rb +7 -0
- data/lib/telnyx/singleton_api_resource.rb +24 -0
- data/lib/telnyx/telnyx_client.rb +545 -0
- data/lib/telnyx/telnyx_object.rb +521 -0
- data/lib/telnyx/telnyx_response.rb +50 -0
- data/lib/telnyx/util.rb +328 -0
- data/lib/telnyx/version.rb +5 -0
- data/lib/telnyx/webhook.rb +66 -0
- data/telnyx.gemspec +25 -0
- data/test/api_stub_helpers.rb +1 -0
- data/test/openapi/README.md +9 -0
- data/test/telnyx/api_operations_test.rb +85 -0
- data/test/telnyx/api_resource_test.rb +293 -0
- data/test/telnyx/available_phone_number_test.rb +14 -0
- data/test/telnyx/errors_test.rb +23 -0
- data/test/telnyx/list_object_test.rb +244 -0
- data/test/telnyx/message_test.rb +19 -0
- data/test/telnyx/messaging_phone_number_test.rb +33 -0
- data/test/telnyx/messaging_profile_test.rb +70 -0
- data/test/telnyx/messaging_sender_id_test.rb +46 -0
- data/test/telnyx/messaging_short_code_test.rb +33 -0
- data/test/telnyx/number_order_test.rb +39 -0
- data/test/telnyx/number_reservation_test.rb +12 -0
- data/test/telnyx/public_key_test.rb +13 -0
- data/test/telnyx/telnyx_client_test.rb +631 -0
- data/test/telnyx/telnyx_object_test.rb +497 -0
- data/test/telnyx/telnyx_response_test.rb +49 -0
- data/test/telnyx/util_test.rb +380 -0
- data/test/telnyx/webhook_test.rb +108 -0
- data/test/telnyx_mock.rb +78 -0
- data/test/telnyx_test.rb +40 -0
- data/test/test_data.rb +149 -0
- data/test/test_helper.rb +73 -0
- metadata +162 -0
@@ -0,0 +1,12 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Telnyx
|
4
|
+
class MessagingSenderId < APIResource
|
5
|
+
include Telnyx::APIOperations::Save
|
6
|
+
include Telnyx::APIOperations::Delete
|
7
|
+
extend Telnyx::APIOperations::List
|
8
|
+
extend Telnyx::APIOperations::Create
|
9
|
+
|
10
|
+
OBJECT_NAME = "messaging_sender_id".freeze
|
11
|
+
end
|
12
|
+
end
|
@@ -0,0 +1,11 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Telnyx
|
4
|
+
class NumberReservation < APIResource
|
5
|
+
extend Telnyx::APIOperations::List
|
6
|
+
extend Telnyx::APIOperations::Create
|
7
|
+
include Telnyx::APIOperations::Save
|
8
|
+
|
9
|
+
OBJECT_NAME = "number_reservation".freeze
|
10
|
+
end
|
11
|
+
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Telnyx
|
4
|
+
class SingletonAPIResource < APIResource
|
5
|
+
def self.resource_url
|
6
|
+
if self == SingletonAPIResource
|
7
|
+
raise NotImplementedError, "SingletonAPIResource is an abstract class. You should perform actions on its subclasses (Account, etc.)"
|
8
|
+
end
|
9
|
+
# Namespaces are separated in object names with periods (.) and in URLs
|
10
|
+
# with forward slashes (/), so replace the former with the latter.
|
11
|
+
"/v2/#{self::OBJECT_NAME.downcase.tr('.', '/')}"
|
12
|
+
end
|
13
|
+
|
14
|
+
def resource_url
|
15
|
+
self.class.resource_url
|
16
|
+
end
|
17
|
+
|
18
|
+
def self.retrieve(opts = {})
|
19
|
+
instance = new(nil, Util.normalize_opts(opts))
|
20
|
+
instance.refresh
|
21
|
+
instance
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
@@ -0,0 +1,545 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module Telnyx
|
4
|
+
# TelnyxClient executes requests against the Telnyx API and allows a user to
|
5
|
+
# recover both a resource a call returns as well as a response object that
|
6
|
+
# contains information on the HTTP call.
|
7
|
+
class TelnyxClient
|
8
|
+
attr_accessor :conn
|
9
|
+
|
10
|
+
# Initializes a new TelnyxClient. Expects a Faraday connection object, and
|
11
|
+
# uses a default connection unless one is passed.
|
12
|
+
def initialize(conn = nil)
|
13
|
+
self.conn = conn || self.class.default_conn
|
14
|
+
@system_profiler = SystemProfiler.new
|
15
|
+
@last_request_metrics = nil
|
16
|
+
end
|
17
|
+
|
18
|
+
def self.active_client
|
19
|
+
Thread.current[:telnyx_client] || default_client
|
20
|
+
end
|
21
|
+
|
22
|
+
def self.default_client
|
23
|
+
Thread.current[:telnyx_client_default_client] ||= TelnyxClient.new(default_conn)
|
24
|
+
end
|
25
|
+
|
26
|
+
# A default Faraday connection to be used when one isn't configured. This
|
27
|
+
# object should never be mutated, and instead instantiating your own
|
28
|
+
# connection and wrapping it in a TelnyxClient object should be preferred.
|
29
|
+
def self.default_conn
|
30
|
+
# We're going to keep connections around so that we can take advantage
|
31
|
+
# of connection re-use, so make sure that we have a separate connection
|
32
|
+
# object per thread.
|
33
|
+
Thread.current[:telnyx_client_default_conn] ||= begin
|
34
|
+
conn = Faraday.new do |builder|
|
35
|
+
builder.use Faraday::Request::Multipart
|
36
|
+
builder.use Faraday::Request::UrlEncoded
|
37
|
+
builder.use Faraday::Response::RaiseError
|
38
|
+
|
39
|
+
# Net::HTTP::Persistent doesn't seem to do well on Windows or JRuby,
|
40
|
+
# so fall back to default there.
|
41
|
+
if Gem.win_platform? || RUBY_PLATFORM == "java"
|
42
|
+
builder.adapter :net_http
|
43
|
+
else
|
44
|
+
builder.adapter :net_http_persistent
|
45
|
+
end
|
46
|
+
end
|
47
|
+
|
48
|
+
if Telnyx.verify_ssl_certs
|
49
|
+
conn.ssl.verify = true
|
50
|
+
else
|
51
|
+
conn.ssl.verify = false
|
52
|
+
|
53
|
+
unless @verify_ssl_warned
|
54
|
+
@verify_ssl_warned = true
|
55
|
+
$stderr.puts("WARNING: Running without SSL cert verification. " \
|
56
|
+
"You should never do this in production. " \
|
57
|
+
"Execute 'Telnyx.verify_ssl_certs = true' to enable verification.")
|
58
|
+
end
|
59
|
+
end
|
60
|
+
|
61
|
+
conn
|
62
|
+
end
|
63
|
+
end
|
64
|
+
|
65
|
+
# Checks if an error is a problem that we should retry on. This includes both
|
66
|
+
# socket errors that may represent an intermittent problem and some special
|
67
|
+
# HTTP statuses.
|
68
|
+
def self.should_retry?(e, num_retries)
|
69
|
+
return false if num_retries >= Telnyx.max_network_retries
|
70
|
+
|
71
|
+
# Retry on timeout-related problems (either on open or read).
|
72
|
+
return true if e.is_a?(Faraday::TimeoutError)
|
73
|
+
|
74
|
+
# Destination refused the connection, the connection was reset, or a
|
75
|
+
# variety of other connection failures. This could occur from a single
|
76
|
+
# saturated server, so retry in case it's intermittent.
|
77
|
+
return true if e.is_a?(Faraday::ConnectionFailed)
|
78
|
+
|
79
|
+
false
|
80
|
+
end
|
81
|
+
|
82
|
+
def self.sleep_time(num_retries)
|
83
|
+
# Apply exponential backoff with initial_network_retry_delay on the
|
84
|
+
# number of num_retries so far as inputs. Do not allow the number to exceed
|
85
|
+
# max_network_retry_delay.
|
86
|
+
sleep_seconds = [Telnyx.initial_network_retry_delay * (2**(num_retries - 1)), Telnyx.max_network_retry_delay].min
|
87
|
+
|
88
|
+
# Apply some jitter by randomizing the value in the range of (sleep_seconds
|
89
|
+
# / 2) to (sleep_seconds).
|
90
|
+
sleep_seconds *= (0.5 * (1 + rand))
|
91
|
+
|
92
|
+
# But never sleep less than the base sleep seconds.
|
93
|
+
sleep_seconds = [Telnyx.initial_network_retry_delay, sleep_seconds].max
|
94
|
+
|
95
|
+
sleep_seconds
|
96
|
+
end
|
97
|
+
|
98
|
+
# Executes the API call within the given block. Usage looks like:
|
99
|
+
#
|
100
|
+
# client = TelnyxClient.new
|
101
|
+
# messaging_profile, resp = client.request { MessagingProfile.create }
|
102
|
+
#
|
103
|
+
def request
|
104
|
+
@last_response = nil
|
105
|
+
old_telnyx_client = Thread.current[:telnyx_client]
|
106
|
+
Thread.current[:telnyx_client] = self
|
107
|
+
|
108
|
+
begin
|
109
|
+
res = yield
|
110
|
+
[res, @last_response]
|
111
|
+
ensure
|
112
|
+
Thread.current[:telnyx_client] = old_telnyx_client
|
113
|
+
end
|
114
|
+
end
|
115
|
+
|
116
|
+
def execute_request(method, path,
|
117
|
+
api_base: nil, api_key: nil, headers: {}, params: {})
|
118
|
+
api_base ||= Telnyx.api_base
|
119
|
+
api_key ||= Telnyx.api_key
|
120
|
+
|
121
|
+
check_api_key!(api_key)
|
122
|
+
|
123
|
+
params = Util.objects_to_ids(params)
|
124
|
+
url = api_url(path, api_base)
|
125
|
+
|
126
|
+
body = nil
|
127
|
+
query_params = nil
|
128
|
+
|
129
|
+
case method.to_s.downcase.to_sym
|
130
|
+
when :get, :head, :delete
|
131
|
+
query_params = params
|
132
|
+
else
|
133
|
+
body = if headers[:content_type] && headers[:content_type] == "multipart/form-data"
|
134
|
+
params
|
135
|
+
else
|
136
|
+
JSON.generate(params)
|
137
|
+
end
|
138
|
+
end
|
139
|
+
|
140
|
+
# This works around an edge case where we end up with both query
|
141
|
+
# parameters in `query_params` and query parameters that are appended
|
142
|
+
# onto the end of the given path. In this case, Faraday will silently
|
143
|
+
# discard the URL's parameters which may break a request.
|
144
|
+
#
|
145
|
+
# Here we decode any parameters that were added onto the end of a path
|
146
|
+
# and add them to `query_params` so that all parameters end up in one
|
147
|
+
# place and all of them are correctly included in the final request.
|
148
|
+
u = URI.parse(path)
|
149
|
+
unless u.query.nil?
|
150
|
+
query_params ||= {}
|
151
|
+
query_params = Hash[URI.decode_www_form(u.query)].merge(query_params)
|
152
|
+
|
153
|
+
# Reset the path minus any query parameters that were specified.
|
154
|
+
path = u.path
|
155
|
+
end
|
156
|
+
|
157
|
+
headers = request_headers(api_key, method)
|
158
|
+
.update(Util.normalize_headers(headers))
|
159
|
+
|
160
|
+
# stores information on the request we're about to make so that we don't
|
161
|
+
# have to pass as many parameters around for logging.
|
162
|
+
context = RequestLogContext.new
|
163
|
+
context.api_key = api_key
|
164
|
+
context.body = body
|
165
|
+
context.method = method
|
166
|
+
context.path = path
|
167
|
+
context.query_params = query_params ? Util.encode_parameters(query_params) : nil
|
168
|
+
|
169
|
+
http_resp = execute_request_with_rescues(api_base, context) do
|
170
|
+
conn.run_request(method, url, body, headers) do |req|
|
171
|
+
req.options.open_timeout = Telnyx.open_timeout
|
172
|
+
req.options.timeout = Telnyx.read_timeout
|
173
|
+
req.params = query_params unless query_params.nil?
|
174
|
+
end
|
175
|
+
end
|
176
|
+
|
177
|
+
begin
|
178
|
+
resp = TelnyxResponse.from_faraday_response(http_resp)
|
179
|
+
rescue JSON::ParserError
|
180
|
+
raise general_api_error(http_resp.status, http_resp.body)
|
181
|
+
end
|
182
|
+
|
183
|
+
# Allows TelnyxClient#request to return a response object to a caller.
|
184
|
+
@last_response = resp
|
185
|
+
[resp, api_key]
|
186
|
+
end
|
187
|
+
|
188
|
+
private
|
189
|
+
|
190
|
+
def api_url(url = "", api_base = nil)
|
191
|
+
(api_base || Telnyx.api_base) + url
|
192
|
+
end
|
193
|
+
|
194
|
+
def check_api_key!(api_key)
|
195
|
+
unless api_key
|
196
|
+
raise AuthenticationError, "No API key provided. " \
|
197
|
+
'Set your API key using "Telnyx.api_key = <API-KEY>". ' \
|
198
|
+
"You can generate API keys from the Telnyx web interface. " \
|
199
|
+
"See https://telnyx.com/api for details, or email support@telnyx.com " \
|
200
|
+
"if you have any questions."
|
201
|
+
end
|
202
|
+
|
203
|
+
return unless api_key =~ /\s/
|
204
|
+
|
205
|
+
raise AuthenticationError, "Your API key is invalid, as it contains " \
|
206
|
+
"whitespace. (HINT: You can double-check your API key from the " \
|
207
|
+
"Telnyx web interface. See https://telnyx.com/api for details, or " \
|
208
|
+
"email support@telnyx.com if you have any questions.)"
|
209
|
+
end
|
210
|
+
|
211
|
+
def execute_request_with_rescues(api_base, context)
|
212
|
+
num_retries = 0
|
213
|
+
begin
|
214
|
+
request_start = Time.now
|
215
|
+
log_request(context, num_retries)
|
216
|
+
resp = yield
|
217
|
+
context = context.dup_from_response(resp)
|
218
|
+
log_response(context, request_start, resp.status, resp.body)
|
219
|
+
|
220
|
+
# We rescue all exceptions from a request so that we have an easy spot to
|
221
|
+
# implement our retry logic across the board. We'll re-raise if it's a type
|
222
|
+
# of exception that we didn't expect to handle.
|
223
|
+
rescue StandardError => e
|
224
|
+
# If we modify context we copy it into a new variable so as not to
|
225
|
+
# taint the original on a retry.
|
226
|
+
error_context = context
|
227
|
+
|
228
|
+
if e.respond_to?(:response) && e.response
|
229
|
+
error_context = context.dup_from_response(e.response)
|
230
|
+
log_response(error_context, request_start,
|
231
|
+
e.response[:status], e.response[:body])
|
232
|
+
else
|
233
|
+
log_response_error(error_context, request_start, e)
|
234
|
+
end
|
235
|
+
|
236
|
+
if self.class.should_retry?(e, num_retries)
|
237
|
+
num_retries += 1
|
238
|
+
sleep self.class.sleep_time(num_retries)
|
239
|
+
retry
|
240
|
+
end
|
241
|
+
|
242
|
+
case e
|
243
|
+
when Faraday::ClientError
|
244
|
+
if e.response
|
245
|
+
handle_error_response(e.response, error_context)
|
246
|
+
else
|
247
|
+
handle_network_error(e, error_context, num_retries, api_base)
|
248
|
+
end
|
249
|
+
|
250
|
+
# Only handle errors when we know we can do so, and re-raise otherwise.
|
251
|
+
# This should be pretty infrequent.
|
252
|
+
else
|
253
|
+
raise
|
254
|
+
end
|
255
|
+
end
|
256
|
+
|
257
|
+
resp
|
258
|
+
end
|
259
|
+
|
260
|
+
def general_api_error(status, body)
|
261
|
+
APIError.new("Invalid response object from API: #{body.inspect} " \
|
262
|
+
"(HTTP response code was #{status})",
|
263
|
+
http_status: status, http_body: body)
|
264
|
+
end
|
265
|
+
|
266
|
+
# Formats a plugin "app info" hash into a string that we can tack onto the
|
267
|
+
# end of a User-Agent string where it'll be fairly prominent in places like
|
268
|
+
# the Dashboard. Note that this formatting has been implemented to match
|
269
|
+
# other libraries, and shouldn't be changed without universal consensus.
|
270
|
+
def format_app_info(info)
|
271
|
+
str = info[:name]
|
272
|
+
str = "#{str}/#{info[:version]}" unless info[:version].nil?
|
273
|
+
str = "#{str} (#{info[:url]})" unless info[:url].nil?
|
274
|
+
str
|
275
|
+
end
|
276
|
+
|
277
|
+
def handle_error_response(http_resp, context)
|
278
|
+
begin
|
279
|
+
resp = TelnyxResponse.from_faraday_hash(http_resp)
|
280
|
+
error_list = resp.data[:errors]
|
281
|
+
|
282
|
+
raise TelnyxError, "Indeterminate error" unless error_list
|
283
|
+
rescue JSON::ParserError, TelnyxError
|
284
|
+
raise general_api_error(http_resp[:status], http_resp[:body])
|
285
|
+
end
|
286
|
+
|
287
|
+
error = specific_api_error(resp, error_list, context)
|
288
|
+
|
289
|
+
error.response = resp
|
290
|
+
raise(error)
|
291
|
+
end
|
292
|
+
|
293
|
+
def specific_api_error(resp, error_list, context)
|
294
|
+
error_list.each do |error|
|
295
|
+
Util.log_error("Telnyx API error",
|
296
|
+
status: resp.http_status,
|
297
|
+
error_code: error[:code],
|
298
|
+
error_detail: error[:detail],
|
299
|
+
error_source: error[:source],
|
300
|
+
error_title: error[:title],
|
301
|
+
request_id: context.request_id)
|
302
|
+
end
|
303
|
+
|
304
|
+
# The standard set of arguments that can be used to initialize most of
|
305
|
+
# the exceptions.
|
306
|
+
opts = {
|
307
|
+
http_body: resp.http_body,
|
308
|
+
http_headers: resp.http_headers,
|
309
|
+
http_status: resp.http_status,
|
310
|
+
json_body: resp.data,
|
311
|
+
}
|
312
|
+
|
313
|
+
case resp.http_status
|
314
|
+
when 400
|
315
|
+
InvalidRequestError.new(error_list, opts)
|
316
|
+
when 401
|
317
|
+
AuthenticationError.new(error_list, opts)
|
318
|
+
when 403
|
319
|
+
PermissionError.new(error_list, opts)
|
320
|
+
when 404
|
321
|
+
ResourceNotFoundError.new(error_list, opts)
|
322
|
+
when 405
|
323
|
+
MethodNotSupportedError.new(error_list, opts)
|
324
|
+
when 408
|
325
|
+
TimeoutError.new(error_list, opts)
|
326
|
+
when 422
|
327
|
+
InvalidParametersError.new(error_list, opts)
|
328
|
+
when 429
|
329
|
+
RateLimitError.new(error_list, opts)
|
330
|
+
when 500
|
331
|
+
APIError.new(error_list, opts)
|
332
|
+
when 503
|
333
|
+
ServiceUnavailableError.new(error_list, opts)
|
334
|
+
else
|
335
|
+
APIError.new(error_list, opts)
|
336
|
+
end
|
337
|
+
end
|
338
|
+
|
339
|
+
def handle_network_error(e, context, num_retries, api_base = nil)
|
340
|
+
Util.log_error("Telnyx network error",
|
341
|
+
error_message: e.message,
|
342
|
+
request_id: context.request_id)
|
343
|
+
|
344
|
+
case e
|
345
|
+
when Faraday::ConnectionFailed
|
346
|
+
message = "Unexpected error communicating when trying to connect to Telnyx. " \
|
347
|
+
"You may be seeing this message because your DNS is not working. " \
|
348
|
+
"To check, try running 'host telnyx.com' from the command line."
|
349
|
+
|
350
|
+
when Faraday::SSLError
|
351
|
+
message = "Could not establish a secure connection to Telnyx, you may " \
|
352
|
+
"need to upgrade your OpenSSL version. To check, try running " \
|
353
|
+
"'openssl s_client -connect api.telnyx.com:443' from the " \
|
354
|
+
"command line."
|
355
|
+
|
356
|
+
when Faraday::TimeoutError
|
357
|
+
api_base ||= Telnyx.api_base
|
358
|
+
message = "Could not connect to Telnyx (#{api_base}). " \
|
359
|
+
"Please check your internet connection and try again. " \
|
360
|
+
"If this problem persists, you should check Telnyx's service status at " \
|
361
|
+
"https://twitter.com/telnyxstatus, or let us know at support@telnyx.com."
|
362
|
+
|
363
|
+
else
|
364
|
+
message = "Unexpected error communicating with Telnyx. " \
|
365
|
+
"If this problem persists, let us know at support@telnyx.com."
|
366
|
+
|
367
|
+
end
|
368
|
+
|
369
|
+
message += " Request was retried #{num_retries} times." if num_retries > 0
|
370
|
+
|
371
|
+
raise APIConnectionError, message + "\n\n(Network error: #{e.message})"
|
372
|
+
end
|
373
|
+
|
374
|
+
def request_headers(api_key, _method)
|
375
|
+
user_agent = "Telnyx/v2 RubyBindings/#{Telnyx::VERSION}"
|
376
|
+
unless Telnyx.app_info.nil?
|
377
|
+
user_agent += " " + format_app_info(Telnyx.app_info)
|
378
|
+
end
|
379
|
+
|
380
|
+
headers = {
|
381
|
+
"User-Agent" => user_agent,
|
382
|
+
"Authorization" => "Bearer #{api_key}",
|
383
|
+
"Content-Type" => "application/json",
|
384
|
+
}
|
385
|
+
|
386
|
+
user_agent = @system_profiler.user_agent
|
387
|
+
begin
|
388
|
+
headers.update(
|
389
|
+
"X-Telnyx-Client-User-Agent" => JSON.generate(user_agent)
|
390
|
+
)
|
391
|
+
rescue StandardError => e
|
392
|
+
headers.update(
|
393
|
+
"X-Telnyx-Client-Raw-User-Agent" => user_agent.inspect,
|
394
|
+
:error => "#{e} (#{e.class})"
|
395
|
+
)
|
396
|
+
end
|
397
|
+
|
398
|
+
headers
|
399
|
+
end
|
400
|
+
|
401
|
+
def log_request(context, num_retries)
|
402
|
+
Util.log_info("Request to Telnyx API",
|
403
|
+
method: context.method,
|
404
|
+
num_retries: num_retries,
|
405
|
+
path: context.path)
|
406
|
+
Util.log_debug("Request details",
|
407
|
+
body: context.body,
|
408
|
+
query_params: context.query_params)
|
409
|
+
end
|
410
|
+
private :log_request
|
411
|
+
|
412
|
+
def log_response(context, request_start, status, body)
|
413
|
+
Util.log_info("Response from Telnyx API",
|
414
|
+
elapsed: Time.now - request_start,
|
415
|
+
method: context.method,
|
416
|
+
path: context.path,
|
417
|
+
request_id: context.request_id,
|
418
|
+
status: status)
|
419
|
+
Util.log_debug("Response details",
|
420
|
+
body: body,
|
421
|
+
request_id: context.request_id)
|
422
|
+
|
423
|
+
return unless context.request_id
|
424
|
+
end
|
425
|
+
private :log_response
|
426
|
+
|
427
|
+
def log_response_error(context, request_start, e)
|
428
|
+
Util.log_error("Request error",
|
429
|
+
elapsed: Time.now - request_start,
|
430
|
+
error_message: e.message,
|
431
|
+
method: context.method,
|
432
|
+
path: context.path)
|
433
|
+
end
|
434
|
+
private :log_response_error
|
435
|
+
|
436
|
+
# RequestLogContext stores information about a request that's begin made so
|
437
|
+
# that we can log certain information. It's useful because it means that we
|
438
|
+
# don't have to pass around as many parameters.
|
439
|
+
class RequestLogContext
|
440
|
+
attr_accessor :body
|
441
|
+
attr_accessor :api_key
|
442
|
+
attr_accessor :method
|
443
|
+
attr_accessor :path
|
444
|
+
attr_accessor :query_params
|
445
|
+
attr_accessor :request_id
|
446
|
+
|
447
|
+
# The idea with this method is that we might want to update some of
|
448
|
+
# context information because a response that we've received from the API
|
449
|
+
# contains information that's more authoritative than what we started
|
450
|
+
# with for a request. For example, we should trust whatever came back in
|
451
|
+
# a `Telnyx-Version` header beyond what configuration information that we
|
452
|
+
# might have had available.
|
453
|
+
def dup_from_response(resp)
|
454
|
+
return self if resp.nil?
|
455
|
+
|
456
|
+
# Faraday's API is a little unusual. Normally it'll produce a response
|
457
|
+
# object with a `headers` method, but on error what it puts into
|
458
|
+
# `e.response` is an untyped `Hash`.
|
459
|
+
headers = if resp.is_a?(Faraday::Response)
|
460
|
+
resp.headers
|
461
|
+
else
|
462
|
+
resp[:headers]
|
463
|
+
end
|
464
|
+
|
465
|
+
context = dup
|
466
|
+
context.request_id = headers["X-Request-Id"]
|
467
|
+
context
|
468
|
+
end
|
469
|
+
end
|
470
|
+
|
471
|
+
# SystemProfiler extracts information about the system that we're running
|
472
|
+
# in so that we can generate a rich user agent header to help debug
|
473
|
+
# integrations.
|
474
|
+
class SystemProfiler
|
475
|
+
def self.uname
|
476
|
+
if ::File.exist?("/proc/version")
|
477
|
+
::File.read("/proc/version").strip
|
478
|
+
else
|
479
|
+
case RbConfig::CONFIG["host_os"]
|
480
|
+
when /linux|darwin|bsd|sunos|solaris|cygwin/i
|
481
|
+
uname_from_system
|
482
|
+
when /mswin|mingw/i
|
483
|
+
uname_from_system_ver
|
484
|
+
else
|
485
|
+
"unknown platform"
|
486
|
+
end
|
487
|
+
end
|
488
|
+
end
|
489
|
+
|
490
|
+
def self.uname_from_system
|
491
|
+
(`uname -a 2>/dev/null` || "").strip
|
492
|
+
rescue Errno::ENOENT
|
493
|
+
"uname executable not found"
|
494
|
+
rescue Errno::ENOMEM # couldn't create subprocess
|
495
|
+
"uname lookup failed"
|
496
|
+
end
|
497
|
+
|
498
|
+
def self.uname_from_system_ver
|
499
|
+
(`ver` || "").strip
|
500
|
+
rescue Errno::ENOENT
|
501
|
+
"ver executable not found"
|
502
|
+
rescue Errno::ENOMEM # couldn't create subprocess
|
503
|
+
"uname lookup failed"
|
504
|
+
end
|
505
|
+
|
506
|
+
def initialize
|
507
|
+
@uname = self.class.uname
|
508
|
+
end
|
509
|
+
|
510
|
+
def user_agent
|
511
|
+
lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
|
512
|
+
|
513
|
+
{
|
514
|
+
application: Telnyx.app_info,
|
515
|
+
bindings_version: Telnyx::VERSION,
|
516
|
+
lang: "ruby",
|
517
|
+
lang_version: lang_version,
|
518
|
+
platform: RUBY_PLATFORM,
|
519
|
+
engine: defined?(RUBY_ENGINE) ? RUBY_ENGINE : "",
|
520
|
+
publisher: "telnyx",
|
521
|
+
uname: @uname,
|
522
|
+
hostname: Socket.gethostname,
|
523
|
+
}.delete_if { |_k, v| v.nil? }
|
524
|
+
end
|
525
|
+
end
|
526
|
+
|
527
|
+
# TelnyxRequestMetrics tracks metadata to be reported to telnyx for metrics collection
|
528
|
+
class TelnyxRequestMetrics
|
529
|
+
# The Telnyx request ID of the response.
|
530
|
+
attr_accessor :request_id
|
531
|
+
|
532
|
+
# Request duration in milliseconds
|
533
|
+
attr_accessor :request_duration_ms
|
534
|
+
|
535
|
+
def initialize(request_id, request_duration_ms)
|
536
|
+
self.request_id = request_id
|
537
|
+
self.request_duration_ms = request_duration_ms
|
538
|
+
end
|
539
|
+
|
540
|
+
def payload
|
541
|
+
{ request_id: request_id, request_duration_ms: request_duration_ms }
|
542
|
+
end
|
543
|
+
end
|
544
|
+
end
|
545
|
+
end
|