Class: Authy::API

Inherits:
Object
  • Object
show all
Extended by:
HTTPClient::IncludeClient
Includes:
URL
Defined in:
lib/authy/api.rb

Overview

Authy.api_key = ‘foo’

Authy.api_uri = 'http://test-authy-api.heroku.com/'

Direct Known Subclasses

OneTouch, PhoneIntelligence, PhoneVerification

Constant Summary collapse

USER_AGENT =
"AuthyRuby/#{Authy::VERSION} (#{RUBY_PLATFORM}, Ruby #{RUBY_VERSION})"
MIN_TOKEN_SIZE =
6
MAX_TOKEN_SIZE =
12

Class Method Summary collapse

Methods included from URL

included

Class Method Details

.delete_user(params) ⇒ Object

options: :id user id



78
79
80
81
82
# File 'lib/authy/api.rb', line 78

def self.delete_user(params)
  user_id = params.delete(:id) || params.delete('id')

  post_request("protected/json/users/delete/:user_id", params.merge({"user_id" =>user_id}))
end

.register_user(attributes) ⇒ Object



20
21
22
23
24
25
26
27
28
29
30
31
32
# File 'lib/authy/api.rb', line 20

def self.register_user(attributes)
  api_key = attributes.delete(:api_key) || Authy.api_key
  send_install_link_via_sms = attributes.delete(:send_install_link_via_sms) { true }
  params = {
    :user => attributes,
    :send_install_link_via_sms => send_install_link_via_sms
  }

  url = "#{Authy.api_uri}/protected/json/users/new"
  response = http_client.post(url, :body => escape_query(params), :header => default_header(api_key: api_key))

  Authy::User.new(response)
end

.request_phone_call(params) ⇒ Object

options: :id user id :force force phone_call



70
71
72
73
74
# File 'lib/authy/api.rb', line 70

def self.request_phone_call(params)
  user_id = params.delete(:id) || params.delete('id')

  get_request("protected/json/call/:user_id", params.merge({"user_id" => user_id}))
end

.request_sms(params) ⇒ Object

options: :id user id :force force sms



61
62
63
64
65
# File 'lib/authy/api.rb', line 61

def self.request_sms(params)
  user_id = params.delete(:id) || params.delete('id')

  get_request("protected/json/sms/:user_id", params.merge({"user_id" => user_id}))
end

.user_status(params) ⇒ Object



84
85
86
87
# File 'lib/authy/api.rb', line 84

def self.user_status(params)
  user_id = params.delete(:id) || params.delete("id")
  get_request("protected/json/users/:user_id/status", params.merge({"user_id" => user_id}))
end

.verify(params) ⇒ Object

options: :id user id :token authy token entered by the user :force (true|false) force to check even if the cellphone is not confirmed



39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
# File 'lib/authy/api.rb', line 39

def self.verify(params)
  token = params.delete(:token) || params.delete('token')
  user_id = params.delete(:id) || params.delete('id')

  return invalid_response('Token format is invalid') unless token_is_safe?(token)
  return invalid_response('User id is invalid') unless is_digit?(user_id)

  params[:force] = true if params[:force].nil? && params['force'].nil?

  response = get_request("protected/json/verify/:token/:user_id", params.merge({
      "token" => token,
      "user_id" => user_id
    })
  )

  return verify_response(response) if response.ok?
  return response
end