Class: ThreeScale::API::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/3scale/api/client.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(http_client) ⇒ Client

Returns a new instance of Client.

Parameters:



8
9
10
 
# File 'lib/3scale/api/client.rb', line 8

def initialize(http_client)
  @http_client = http_client
end

Instance Attribute Details

#http_client ⇒ Object (readonly)

Returns the value of attribute http_client.



4
5
6
 
# File 'lib/3scale/api/client.rb', line 4

def http_client
  @http_client
end

Instance Method Details

#create_application(account_id, attributes = {}, plan_id:, **rest) ⇒ Hash

Returns an Application.

Parameters:

  • plan_id (Fixnum) —

    Application Plan ID

  • attributes (Hash) (defaults to: {}) —

    Application Attributes

Options Hash (attributes):

  • :name (String) —

    Application Name

  • :description (String) —

    Application Description

  • :user_key (String) —

    Application User Key

  • :application_id (String) —

    Application App ID

  • :application_key (String) —

    Application App Key(s)

Returns:

  • (Hash) —

    an Application



63
64
65
66
67
 
# File 'lib/3scale/api/client.rb', line 63

def create_application(, attributes = {}, plan_id:, **rest)
  body = { plan_id: plan_id }.merge(attributes).merge(rest)
  response = http_client.post("/admin/api/accounts/#{account_id}/applications", body: body)
  extract(entity: 'application', from: response)
end

#create_application_plan(service_id, attributes) ⇒ Hash

Parameters:

  • service_id (Fixnum) —

    Service ID

  • attributes (Hash) —

    Metric Attributes

Options Hash (attributes):

  • :name (String) —

    Application Plan Name

Returns:

  • (Hash) 


239
240
241
242
243
 
# File 'lib/3scale/api/client.rb', line 239

def create_application_plan(service_id, attributes)
  response = http_client.post("/admin/api/services/#{service_id}/application_plans",
                              body: { application_plan: attributes })
  extract(entity: 'application_plan', from: response)
end

#create_application_plan_limit(application_plan_id, metric_id, attributes) ⇒ Hash

Parameters:

  • application_plan_id (Fixnum) —

    Application Plan ID

  • attributes (Hash) —

    Metric Attributes

  • metric_id (Fixnum) —

    Metric ID

Options Hash (attributes):

  • :period (String) —

    Usage Limit period

  • :value (String) —

    Usage Limit value

Returns:

  • (Hash) 


261
262
263
264
265
 
# File 'lib/3scale/api/client.rb', line 261

def create_application_plan_limit(application_plan_id, metric_id, attributes)
  response = http_client.post("/admin/api/application_plans/#{application_plan_id}/metrics/#{metric_id}/limits",
                              body: { usage_limit: attributes })
  extract(entity: 'limit', from: response)
end

#create_mapping_rule(service_id, attributes) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

  • attributes (Hash) —

    Mapping Rule Attributes

Options Hash (attributes):

  • :http_method (String) —

    HTTP Method

  • :pattern (String) —

    Pattern

  • :delta (Fixnum) —

    Increase the metric by delta.

  • :metric_id (Fixnum) —

    Metric ID

Returns:

  • (Array<Hash>) 


156
157
158
159
160
 
# File 'lib/3scale/api/client.rb', line 156

def create_mapping_rule(service_id, attributes)
  response = http_client.post("/admin/api/services/#{service_id}/proxy/mapping_rules",
                              body: { mapping_rule: attributes })
  extract(entity: 'mapping_rule', from: response)
end

#create_method(service_id, metric_id, attributes) ⇒ Hash

Parameters:

  • service_id (Fixnum) —

    Service ID

  • metric_id (Fixnum) —

    Metric ID

  • attributes (Hash) —

    Metric Attributes

Options Hash (attributes):

  • :name (String) —

    Method Name

Returns:

  • (Hash) 


219
220
221
222
223
 
# File 'lib/3scale/api/client.rb', line 219

def create_method(service_id, metric_id, attributes)
  response = http_client.post("/admin/api/services/#{service_id}/metrics/#{metric_id}/methods",
                              body: { metric: attributes })
  extract(entity: 'method', from: response)
end

#create_metric(service_id, attributes) ⇒ Hash

Parameters:

  • service_id (Fixnum) —

    Service ID

  • attributes (Hash) —

    Metric Attributes

Options Hash (attributes):

  • :name (String) —

    Metric Name

Returns:

  • (Hash) 


199
200
201
202
 
# File 'lib/3scale/api/client.rb', line 199

def create_metric(service_id, attributes)
  response = http_client.post("/admin/api/services/#{service_id}/metrics", body: { metric: attributes })
  extract(entity: 'metric', from: response)
end

#create_service(attributes) ⇒ Hash

Parameters:

  • attributes (Hash) —

    Service Attributes

Options Hash (attributes):

  • :name (String) —

    Service Name

Returns:

  • (Hash) 


99
100
101
102
 
# File 'lib/3scale/api/client.rb', line 99

def create_service(attributes)
  response = http_client.post('/admin/api/services', body: { service: attributes })
  extract(entity: 'service', from: response)
end

#customize_application_plan(account_id, application_id) ⇒ Hash

Returns a Plan.

Parameters:

  • account_id (Fixnum) —

    Account ID

  • application_id (Fixnum) —

    Application ID

Returns:

  • (Hash) —

    a Plan



73
74
75
76
 
# File 'lib/3scale/api/client.rb', line 73

def customize_application_plan(, application_id)
  response = http_client.put("/admin/api/accounts/#{account_id}/applications/#{application_id}/customize_plan")
  extract(entity: 'application_plan', from: response)
end

#delete_application_plan_limit(application_plan_id, metric_id, limit_id) ⇒ Object

Parameters:

  • application_plan_id (Fixnum) —

    Application Plan ID

  • metric_id (Fixnum) —

    Metric ID

  • limit_id (Fixnum) —

    Usage Limit ID



270
271
272
273
 
# File 'lib/3scale/api/client.rb', line 270

def delete_application_plan_limit(application_plan_id, metric_id, limit_id)
  http_client.delete("/admin/api/application_plans/#{application_plan_id}/metrics/#{metric_id}/limits/#{limit_id}")
  true
end

#delete_mapping_rule(service_id, id) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

  • id (Fixnum) —

    Mapping Rule ID

Returns:

  • (Array<Hash>) 


166
167
168
169
 
# File 'lib/3scale/api/client.rb', line 166

def delete_mapping_rule(service_id, id)
  http_client.delete("/admin/api/services/#{service_id}/proxy/mapping_rules/#{id}")
  true
end

#find_application(id: nil, user_key: nil, application_id: nil) ⇒ Hash

Parameters:

  • id (Fixnum) (defaults to: nil) —

    Application ID

  • user_key (String) (defaults to: nil) —

    Application User Key

  • application_id (String) (defaults to: nil) —

    Application App ID

Returns:

  • (Hash) 


48
49
50
51
52
 
# File 'lib/3scale/api/client.rb', line 48

def find_application(id: nil, user_key: nil, application_id: nil)
  params = { application_id: id, user_key: user_key, app_id: application_id }.reject { |_, value| value.nil? }
  response = http_client.get('/admin/api/applications/find', params: params)
  extract(entity: 'application', from: response)
end

#list_application_plan_limits(application_plan_id) ⇒ Array<Hash>

Parameters:

  • application_plan_id (Fixnum) —

    Application Plan ID

Returns:

  • (Array<Hash>) 


248
249
250
251
252
 
# File 'lib/3scale/api/client.rb', line 248

def list_application_plan_limits(application_plan_id)
  response = http_client.get("/admin/api/application_plans/#{application_plan_id}/limits")

  extract(collection: 'limits', entity: 'limit', from: response)
end

#list_applications(service_id: nil) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) (defaults to: nil) —

    Service ID

Returns:

  • (Array<Hash>) 


30
31
32
33
34
 
# File 'lib/3scale/api/client.rb', line 30

def list_applications(service_id: nil)
  params = service_id ? { service_id: service_id } : nil
  response = http_client.get('/admin/api/applications', params: params)
  extract(collection: 'applications', entity: 'application', from: response)
end

#list_mapping_rules(service_id) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

Returns:

  • (Array<Hash>) 


134
135
136
137
 
# File 'lib/3scale/api/client.rb', line 134

def list_mapping_rules(service_id)
  response = http_client.get("/admin/api/services/#{service_id}/proxy/mapping_rules")
  extract(entity: 'mapping_rule', collection: 'mapping_rules', from: response)
end

#list_methods(service_id, metric_id) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

  • metric_id (Fixnum) —

    Metric ID

Returns:

  • (Array<Hash>) 


208
209
210
211
 
# File 'lib/3scale/api/client.rb', line 208

def list_methods(service_id, metric_id)
  response = http_client.get("/admin/api/services/#{service_id}/metrics/#{metric_id}/methods")
  extract(collection: 'methods', entity: 'method', from: response)
end

#list_metrics(service_id) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

Returns:

  • (Array<Hash>) 


189
190
191
192
 
# File 'lib/3scale/api/client.rb', line 189

def list_metrics(service_id)
  response = http_client.get("/admin/api/services/#{service_id}/metrics")
  extract(collection: 'metrics', entity: 'metric', from: response)
end

#list_service_application_plans(service_id) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

Returns:

  • (Array<Hash>) 


228
229
230
231
232
 
# File 'lib/3scale/api/client.rb', line 228

def list_service_application_plans(service_id)
  response = http_client.get("/admin/api/services/#{service_id}/application_plans")

  extract(collection: 'plans', entity: 'application_plan', from: response)
end

#list_services ⇒ Array<Hash>

Returns:

  • (Array<Hash>) 


22
23
24
25
 
# File 'lib/3scale/api/client.rb', line 22

def list_services
  response = http_client.get('/admin/api/services')
  extract(collection: 'services', entity: 'service', from: response)
end

#show_application(id) ⇒ Hash

Parameters:

  • id (Fixnum) —

    Application ID

Returns:

  • (Hash) 


39
40
41
 
# File 'lib/3scale/api/client.rb', line 39

def show_application(id)
  find_application(id: id)
end

#show_mapping_rule(service_id, id) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

  • id (Fixnum) —

    Mapping Rule ID

Returns:

  • (Array<Hash>) 


143
144
145
146
 
# File 'lib/3scale/api/client.rb', line 143

def show_mapping_rule(service_id, id)
  response = http_client.get("/admin/api/services/#{service_id}/proxy/mapping_rules/#{id}")
  extract(entity: 'mapping_rule', from: response)
end

#show_proxy(service_id) ⇒ Hash

Parameters:

  • service_id (Fixnum) —

    Service ID

Returns:

  • (Hash) 


117
118
119
120
 
# File 'lib/3scale/api/client.rb', line 117

def show_proxy(service_id)
  response = http_client.get("/admin/api/services/#{service_id}/proxy")
  extract(entity: 'proxy', from: response)
end

#show_service(id) ⇒ Hash

Parameters:

  • id (Fixnum) —

    Service ID

Returns:

  • (Hash) 


15
16
17
18
 
# File 'lib/3scale/api/client.rb', line 15

def show_service(id)
  response = http_client.get("/admin/api/services/#{id}")
  extract(entity: 'service', from: response)
end

#signup(attributes = {}, name:, username:, **rest) ⇒ Hash

Returns an Account.

Parameters:

  • name (String) —

    Account Name

  • username (String) —

    User Username

  • attributes (Hash) (defaults to: {}) —

    User and Account Attributes

Options Hash (attributes):

  • :email (String) —

    User Email

  • :password (String) —

    User Password

  • :account_plan_id (String) —

    Account Plan ID

  • :service_plan_id (String) —

    Service Plan ID

  • :application_plan_id (String) —

    Application Plan ID

Returns:

  • (Hash) —

    an Account



88
89
90
91
92
93
 
# File 'lib/3scale/api/client.rb', line 88

def (attributes = {}, name:, username:, **rest)
  body = { org_name: name,
           username: username }.merge(attributes).merge(rest)
  response = http_client.post('/admin/api/signup', body: body)
  extract(entity: 'account', from: response)
end

#update_mapping_rule(service_id, id, attributes) ⇒ Array<Hash>

Parameters:

  • service_id (Fixnum) —

    Service ID

  • id (Fixnum) —

    Mapping Rule ID

  • attributes (Hash) —

    Mapping Rule Attributes

Options Hash (attributes):

  • :http_method (String) —

    HTTP Method

  • :pattern (String) —

    Pattern

  • :delta (Fixnum) —

    Increase the metric by delta.

  • :metric_id (Fixnum) —

    Metric ID

Returns:

  • (Array<Hash>) 


180
181
182
183
184
 
# File 'lib/3scale/api/client.rb', line 180

def update_mapping_rule(service_id, id, attributes)
  response = http_client.patch("/admin/api/services/#{service_id}/mapping_rules/#{id}",
                               body: { mapping_rule: attributes })
  extract(entity: 'mapping_rule', from: response)
end

#update_proxy(service_id, attributes) ⇒ Hash

Parameters:

  • service_id (Fixnum) —

    Service ID

Returns:

  • (Hash) 


125
126
127
128
129
 
# File 'lib/3scale/api/client.rb', line 125

def update_proxy(service_id, attributes)
  response = http_client.patch("/admin/api/services/#{service_id}/proxy",
                               body: { proxy: attributes })
  extract(entity: 'proxy', from: response)
end

#update_service(service_id, attributes) ⇒ Hash

Parameters:

  • service_id (Fixnum) —

    Service ID

  • attributes (Hash) —

    Service Attributes

Options Hash (attributes):

  • :name (String) —

    Service Name

Returns:

  • (Hash) 


109
110
111
112
 
# File 'lib/3scale/api/client.rb', line 109

def update_service(service_id, attributes)
  response = http_client.put("/admin/api/services/#{service_id}", body: { service: attributes })
  extract(entity: 'service', from: response)
end