pokitdok-ruby 0.7.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ca5d31a1c7e95167bd3ed9f12e4aba0c624c686c
-  data.tar.gz: f9e90f70867044ab5e21e368af36be2a3a74c746
+  metadata.gz: d8d295a4e720cbc16c0760e1bd39f0458d2dbff0
+  data.tar.gz: 35fd84a68b5c6dd2e9e17d0e3afc3c02668679ab
 SHA512:
-  metadata.gz: 9e93d53e3ce03a1b21456c9415d2367899dd7f94f8b144a247dfa3d14ab3625540d5858eded8776ce7186c94879e73920d713a71d5d64d4d3176a82c8e2c8cba
-  data.tar.gz: 68a3519c467121ca748435a8e712231193436ab66fef7ff38fb56d234225b15f51b1a0be91f04ab53036cd2f007f82910b42c738d65db65c5ec2180d49ee4a05
+  metadata.gz: d167b436927487759778b7a40f43595ea29f06386389ad9f721a76e8f50bdff1cc53f99e6b663c844d2c916e9d76443af5fa02144fc28778590c60e797499133
+  data.tar.gz: 07387fa5e0f1959879ec98219c709b49073808dc7483eacfd5fe576aa616aa26e20fee638c14a90562dcfee2c5bb72df9bfa86c3c737aba5c1b8a9979ed86f7e

data/Gemfile

@@ -16,6 +16,7 @@ group :development do
 	gem 'webmock', '~> 1.17'
 	gem 'guard', '~> 2.6'
 	gem 'guard-minitest', '~> 2.2'
+	gem 'terminal-notifier'
 	gem 'terminal-notifier-guard', '~> 1.5'
 	gem 'guard-rubocop', '~> 1.0'
 	gem 'coveralls', require: false

data/Gemfile.lock

@@ -1,8 +1,8 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    addressable (2.3.6)
-    ansi (1.4.3)
+    addressable (2.3.8)
+    ansi (1.5.0)
     ast (2.0.0)
     astrolabe (1.3.0)
       parser (>= 2.2.0.pre.3, < 3.0)
@@ -10,45 +10,53 @@ GEM
     celluloid (0.16.0)
       timers (~> 4.0.0)
     coderay (1.1.0)
-    coveralls (0.7.1)
-      multi_json (~> 1.3)
-      rest-client
-      simplecov (>= 0.7)
-      term-ansicolor
-      thor
+    coveralls (0.8.1)
+      json (~> 1.8)
+      rest-client (>= 1.6.8, < 2)
+      simplecov (~> 0.10.0)
+      term-ansicolor (~> 1.3)
+      thor (~> 0.19.1)
     crack (0.4.2)
       safe_yaml (~> 1.0.0)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
     docile (1.1.5)
-    faraday (0.9.0)
+    domain_name (0.5.24)
+      unf (>= 0.0.5, < 1.0.0)
+    faraday (0.9.1)
       multipart-post (>= 1.2, < 3)
-    ffi (1.9.6)
+    ffi (1.9.8)
     formatador (0.2.5)
-    git (1.2.8)
-    github_api (0.12.1)
+    git (1.2.9.1)
+    github_api (0.12.3)
       addressable (~> 2.3)
       descendants_tracker (~> 0.0.4)
       faraday (~> 0.8, < 0.10)
-      hashie (>= 3.2)
+      hashie (>= 3.3)
       multi_json (>= 1.7.5, < 2.0)
       nokogiri (~> 1.6.3)
       oauth2
-    guard (2.6.1)
+    guard (2.12.5)
       formatador (>= 0.2.4)
       listen (~> 2.7)
       lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
       pry (>= 0.9.12)
+      shellany (~> 0.0)
       thor (>= 0.18.1)
-    guard-minitest (2.3.2)
-      guard (~> 2.0)
+    guard-compat (1.2.1)
+    guard-minitest (2.4.4)
+      guard-compat (~> 1.2)
       minitest (>= 3.0)
-    guard-rubocop (1.1.0)
+    guard-rubocop (1.2.0)
       guard (~> 2.0)
       rubocop (~> 0.20)
-    hashie (3.3.1)
-    highline (1.6.21)
+    hashie (3.4.1)
+    highline (1.7.2)
     hitimes (1.2.2)
+    http-cookie (1.0.2)
+      domain_name (~> 0.5)
     jeweler (2.0.1)
       builder
       bundler (>= 1.0)
@@ -58,80 +66,89 @@ GEM
       nokogiri (>= 1.5.10)
       rake
       rdoc
-    json (1.8.1)
-    jwt (1.0.0)
-    listen (2.7.11)
-      celluloid (>= 0.15.2)
+    json (1.8.2)
+    jwt (1.5.0)
+    listen (2.10.0)
+      celluloid (~> 0.16.0)
       rb-fsevent (>= 0.9.3)
       rb-inotify (>= 0.9)
     lumberjack (1.0.9)
     metaclass (0.0.4)
     method_source (0.8.2)
-    mime-types (2.4.3)
-    mini_portile (0.6.0)
-    minitest (5.4.2)
-    minitest-reporters (1.0.6)
+    mime-types (2.5)
+    mini_portile (0.6.2)
+    minitest (5.6.1)
+    minitest-reporters (1.0.16)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
     mocha (1.1.0)
       metaclass (~> 0.0.1)
-    multi_json (1.10.1)
+    multi_json (1.11.0)
     multi_xml (0.5.5)
     multipart-post (2.0.0)
-    netrc (0.8.0)
-    nokogiri (1.6.3.1)
-      mini_portile (= 0.6.0)
+    nenv (0.2.0)
+    netrc (0.10.3)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    notiffany (0.0.6)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
     oauth2 (0.9.4)
       faraday (>= 0.8, < 0.10)
       jwt (~> 1.0)
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (~> 1.2)
-    parser (2.2.0.pre.5)
+    parser (2.2.2.3)
       ast (>= 1.1, < 3.0)
-      slop (~> 3.4, >= 3.4.5)
-    powerpack (0.0.9)
+    powerpack (0.1.1)
     pry (0.10.1)
       coderay (~> 1.1.0)
       method_source (~> 0.8.1)
       slop (~> 3.4)
-    rack (1.5.2)
+    rack (1.6.1)
     rainbow (2.0.0)
-    rake (10.3.2)
-    rb-fsevent (0.9.4)
+    rake (10.4.2)
+    rb-fsevent (0.9.5)
     rb-inotify (0.9.5)
       ffi (>= 0.5.0)
-    rdoc (4.1.2)
+    rdoc (4.2.0)
       json (~> 1.4)
-    rest-client (1.7.2)
+    rest-client (1.8.0)
+      http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 3.0)
       netrc (~> 0.7)
-    rubocop (0.26.1)
+    rubocop (0.31.0)
       astrolabe (~> 1.3)
-      parser (>= 2.2.0.pre.4, < 3.0)
-      powerpack (~> 0.0.6)
+      parser (>= 2.2.2.1, < 3.0)
+      powerpack (~> 0.1)
       rainbow (>= 1.99.1, < 3.0)
       ruby-progressbar (~> 1.4)
-    ruby-progressbar (1.6.0)
+    ruby-progressbar (1.7.5)
     safe_yaml (1.0.4)
-    simplecov (0.9.1)
+    shellany (0.0.1)
+    simplecov (0.10.0)
       docile (~> 1.1.0)
-      multi_json (~> 1.0)
-      simplecov-html (~> 0.8.0)
-    simplecov-html (0.8.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
     slop (3.6.0)
     term-ansicolor (1.3.0)
       tins (~> 1.0)
-    terminal-notifier-guard (1.6.0)
+    terminal-notifier (1.6.3)
+    terminal-notifier-guard (1.6.4)
     thor (0.19.1)
-    thread_safe (0.3.4)
+    thread_safe (0.3.5)
     timers (4.0.1)
       hitimes
-    tins (1.3.3)
+    tins (1.5.1)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.1)
     vcr (2.9.3)
-    webmock (1.20.0)
+    webmock (1.21.0)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
 
@@ -154,6 +171,7 @@ DEPENDENCIES
   rdoc (~> 4.1)
   rubocop (~> 0.20)
   simplecov (~> 0.8)
+  terminal-notifier
   terminal-notifier-guard (~> 1.5)
   vcr (~> 2.9)
   webmock (~> 1.17)

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 PokitDok, Inc.
+Copyright (c) 2015 PokitDok, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/VERSION

@@ -1 +1 @@
-0.7.1
+0.7.2

data/lib/pokitdok.rb

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright (C) 2014, All Rights Reserved, PokitDok, Inc.
+# Copyright (C) 2014-2015, All Rights Reserved, PokitDok, Inc.
 # https://www.pokitdok.com
 #
 # Please see the LICENSE.txt file for more information.
@@ -20,7 +20,6 @@ module PokitDok
     POKITDOK_URL_BASE = 'https://platform.pokitdok.com' # :nodoc:
 
     attr_reader :client # :nodoc:
-    attr_reader :token  # :nodoc:
     attr_reader :api_url
     attr_reader :version
 
@@ -37,123 +36,109 @@ module PokitDok
       @version = version
 
       @api_url = "#{url_base}/api/#{version}"
-
       @client = OAuth2::Client.new(@client_id, @client_secret,
                                    site: @api_url, token_url: '/oauth2/token')
-      refresh_token
-    end
 
-    def url_base
-      POKITDOK_URL_BASE
-    end
 
-    def user_agent
-      "pokitdok-ruby 0.7.1 #{RUBY_DESCRIPTION}"
+      @scopes = {}
+      @scopes['default'] = { scope: refresh_token }
+      scope 'default'
     end
 
-    # returns a standard set of headers to be passed along with all requests
-    def headers
-      { 'User-Agent' => user_agent }
+    # Accessor for the PokitDok Platform URL, overridable for testing.
+    def url_base
+      POKITDOK_URL_BASE
     end
 
-    # Refreshes the client token associated with this PokitDok connection
+    # Adds an authorization code for a given OAuth2 scope.
+    #
+    # +name+ the scope name
+    # +code+ the authorization code
     #
-    # FIXME: automatic refresh on expiration
-    def refresh_token
-      @token = client.client_credentials.get_token(
-        headers: { 'Authorization' => 'Basic' })
+    def scope_code(name, code)
+      @scopes[name] = { code: code }
     end
 
-    # Invokes the activities endpoint, with an optional Hash of parameters.
+    # Invokes the appointments endpoint, to query for open appointment slots
+    # (using pd_provider_uuid and location) or booked appointments (using
+    # patient_uuid).
+    #
+    # +params+ an optional Hash of parameters
+    #
     def activities(params = {})
-      response = @token.get('activities/',
-                            headers: headers,
-                            params: params)
-      JSON.parse(response.body)
+      scope 'default'
+      get('activities/', params)
     end
 
-    # Invokes the authorizations endpoint, with an optional Hash of parameters.
+    # Invokes the authorizations endpoint.
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
     def authorizations(params = {})
-      response = @token.post('authorizations/',
-                             headers: headers,
-                             body: params.to_json) do |request|
-        request.headers['Content-Type'] = 'application/json'
-      end
-      JSON.parse(response.body)
+      scope 'default'
+      post('authorizations/', params)
     end
 
-    # Invokes the cash prices endpoint, with an optional Hash of parameters.
+    # Invokes the cash prices endpoint.
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
     def cash_prices(params = {})
-      response = @token.get('prices/cash',
-                             headers: headers,
-                             params: params)
-      JSON.parse(response.body)
+      scope 'default'
+      get('prices/cash', params)
     end
 
-    # Invokes the insurance prices endpoint, with an optional Hash of parameters.
-    def insurance_prices(params = {})
-      response = @token.get('prices/insurance',
-                             headers: headers,
-                             params: params)
-      JSON.parse(response.body)
-    end
-
-    # Invokes the claims endpoint, with an optional Hash of parameters.
+    # Invokes the claims endpoint.
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
     def claims(params = {})
-      response = @token.post('claims/',
-                             headers: headers,
-                             body: params.to_json) do |request|
-        request.headers['Content-Type'] = 'application/json'
-      end
-      JSON.parse(response.body)
+      scope 'default'
+      post('claims/', params)
     end
 
-    # Invokes the claims status endpoint, with an optional Hash of parameters.
+    # Invokes the claims status endpoint.
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
     def claims_status(params = {})
-      response = @token.post('claims/status',
-                             headers: headers,
-                             body: params.to_json) do |request|
-        request.headers['Content-Type'] = 'application/json'
-      end
-      JSON.parse(response.body)
+      scope 'default'
+      post('claims/status', params)
     end
 
-
-    # Invokes the eligibility endpoint, with an optional Hash of parameters.
+    # Invokes the eligibility endpoint.
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
     def eligibility(params = {})
-      response = @token.post('eligibility/',
-                             headers: headers,
-                             body: params.to_json) do |request|
-        request.headers['Content-Type'] = 'application/json'
-      end
-      JSON.parse(response.body)
+      scope 'default'
+      post('eligibility/', params)
     end
 
-    # Invokes the enrollment endpoint, with an optional Hash of parameters.
+    # Invokes the enrollment endpoint.
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
     def enrollment(params = {})
-      response = @token.post('enrollment/',
-                             headers: headers,
-                             body: params.to_json) do |request|
-        request.headers['Content-Type'] = 'application/json'
-      end
-      JSON.parse(response.body)
+      scope 'default'
+      post('enrollment/', params)
     end
 
     # Uploads an EDI file to the files endpoint.
     # Uses the multipart-post gem, since oauth2 doesn't support multipart.
     #
     # +trading_partner_id+ the trading partner to transmit to
-    #
     # +filename+ the path to the file to transmit
     #
     def files(trading_partner_id, filename)
+      scope 'default'
       url = URI.parse(@api_url + '/files/')
 
       File.open(filename) do |f|
         req = Net::HTTP::Post::Multipart.new url.path,
           'file' => UploadIO.new(f, 'application/EDI-X12', filename),
           'trading_partner_id' => trading_partner_id
-        req['Authorization'] = "Bearer #{@token.token}"
+        req['Authorization'] = "Bearer #{default_scope.token}"
         req['User-Agent'] = user_agent
 
         @response = Net::HTTP.start(url.host, url.port) do |http|
@@ -164,54 +149,305 @@ module PokitDok
       JSON.parse(@response.body)
     end
 
-    # Invokes the payers endpoint, with an optional Hash of parameters.
+    # Invokes the insurance prices endpoint.
+    #
+    # +params+ an optional hash of parameters
+    #
+    def insurance_prices(params = {})
+      scope 'default'
+      get('prices/insurance', params)
+    end
+
+    # Invokes the payers endpoint.
+    #
+    # +params+ an optional hash of parameters
+    #
     def payers(params = {})
-      response = @token.get('payers/', headers: headers, params: params)
-      JSON.parse(response.body)
+      scope 'default'
+      get('payers/', params)
     end
 
-    # Invokes the plans endpoint, with an optional Hash of parameters.
+    # Invokes the plans endpoint.
+    #
+    # +params+ an optional Hash of parameters
+    #
     def plans(params = {})
-      response = @token.get('plans/', headers: headers, params: params)
-      JSON.parse(response.body)
+      scope 'default'
+      get('plans/', params)
     end
 
-    # Invokes the providers endpoint, with an optional Hash of parameters.
+    # Invokes the providers endpoint.
+    #
+    # +params+ an optional Hash of parameters
+    #
     def providers(params = {})
-      response = @token.get('providers/') do |request|
+      response = default_scope.get('providers/') do |request|
         request.params = params
       end
       JSON.parse(response.body)
     end
 
-    # Invokes the referrals endpoint, with an optional Hash of parameters.
+    # Invokes the referrals endpoint.
+    #
+    # +params+ an optional Hash of parameters
+    #
     def referrals(params = {})
-      response = @token.post('referrals/',
-                             headers: headers,
-                             body: params.to_json) do |request|
-        request.headers['Content-Type'] = 'application/json'
-      end
-      JSON.parse(response.body)
+      scope 'default'
+      post('referrals/', params)
     end
 
-    # Invokes the trading partners endpoint, with an optional Hash of
-    # parameters.
+    # Invokes the trading partners endpoint.
+    #
+    # +params+ an optional Hash of parameters
+    #
     def trading_partners(params = {})
       trading_partner_id = params.delete :trading_partner_id
 
       response =
-      @token.get("tradingpartners/#{trading_partner_id}") do |request|
-        request.params = params
-      end
+        default_scope.get("tradingpartners/#{trading_partner_id}") do |request|
+          request.params = params
+        end
       JSON.parse(response.body)
     end
 
-    # Invokes the plans endpoint, with a hash of parameters
-    def plans(params = {})
-      response = @token.get('plans/', headers: headers, params: params) do |request|
+    # Scheduling endpoints
+
+    # Invokes the appointments endpoint to query for an open appointment
+    # slot or a booked appointment given a specific pd_appointment_uuid,
+    # the PokitDok unique appointment identifier.
+    #
+    # +params+ an optional Hash of parameters
+    #
+    def appointment(params = {})
+      @appointment_id = params.delete :appointment_id
+      scope 'user_schedule'
+
+      get_one('schedule/appointmenttypes/', @appointment_id, params)
+    end
+
+    # Invokes the activities endpoint.
+    #
+    # This endpoint uses the user_schedule OAuth2 scope. You'll need to
+    # get the user's authorization via our OAuth2 provider, and pass the
+    # authorization code you received into
+    # scope_code('user_schedule', '(the authorization code)')
+    #
+    # +params+ an optional Hash of parameters
+    #
+    def appointments(params = {})
+      scope 'user_schedule'
+      get('schedule/appointments/', params)
+    end
+
+    # Invokes the appointment_types endpoint, to get information on a specific
+    # appointment type.
+    #
+    # +params+ an optional Hash of parameters
+    #
+    def appointment_type(params = {})
+      appointment_type = params.delete :uuid
+
+      response =
+      default_scope.get("schedule/appointmenttypes/#{appointment_type}") do |request|
         request.params = params
       end
+
+      JSON.parse(response.body)
+    end
+
+    # Invokes the appointment_types endpoint.
+    #
+    # +params+ an optional hash of parameters
+    #
+    def appointment_types(params = {})
+      scope 'default'
+      get('schedule/appointmenttypes/', params)
+    end
+
+    # Books an appointment.
+    #
+    # This endpoint uses the user_schedule OAuth2 scope. You'll need to
+    # get the user's authorization via our OAuth2 provider, and pass the
+    # authorization code you received into
+    # scope_code('user_schedule', '(the authorization code)')
+    #
+    # +params+ an optional hash of parameters that will be sent in the POST body
+    #
+    def book_appointment(appointment_uuid, params = {})
+      scope 'user_schedule'
+      
+      put_one("schedule/appointments", appointment_uuid, params)
+    end
+
+    # Cancels the specified appointment.
+    #
+    # This endpoint uses the user_schedule OAuth2 scope. You'll need to
+    # get the user's authorization via our OAuth2 provider, and pass the
+    # authorization code you received into
+    # scope_code('user_schedule', '(the authorization code)')
+    #    
+    # +params+ an optional Hash of parameters
+    #
+    def cancel_appointment(appointment_uuid, params={})
+      scope 'user_schedule'
+
+      delete_one("schedule/appointments", appointment_uuid, params)
+    end
+
+    # Invokes the schedule/appointments endpoint.
+    #
+    # This endpoint uses the user_schedule OAuth2 scope. You'll need to
+    # get the user's authorization via our OAuth2 provider, and pass the
+    # authorization code you received into
+    # scope_code('user_schedule', '(the authorization code)')
+    #    
+    # +params+ an optional hash of parameters
+    #
+    def open_appointment_slots(params = {})
+      scope 'user_schedule'
+      get('schedule/appointments', params)
+    end
+
+    # Invokes the schedulers endpoint.
+    #
+    # +params an optional Hash of parameters
+    #
+    def schedulers(params = {})
+      scope 'default'
+      get('schedule/schedulers/', params)
+    end
+
+    # Invokes the schedulers endpoint, to get information about a specific
+    # scheduler.
+    #
+    # +params+ an optional Hash of parameters
+    #
+    def scheduler(params = {})
+      scheduler_id = params.delete :uuid
+
+      response =
+        default_scope.get("schedule/schedulers/#{scheduler_id}") do |request|
+          request.params = params
+        end
       JSON.parse(response.body)
     end
+
+    # Invokes the slots endpoint.
+    #
+    # This endpoint uses the user_schedule OAuth2 scope. You'll need to
+    # get the user's authorization via our OAuth2 provider, and pass the
+    # authorization code you received into
+    # scope_code('user_schedule', '(the authorization code)')
+    #    
+    # +params+ an optional Hash of parameters
+    #
+    def slots(params = {})
+      scope 'user_schedule'
+    end
+
+    # Updates the specified appointment.
+    #
+    # This endpoint uses the user_schedule OAuth2 scope. You'll need to
+    # get the user's authorization via our OAuth2 provider, and pass the
+    # authorization code you received into
+    # scope_code('user_schedule', '(the authorization code)')
+    #    
+    # +params+ an optional Hash of parameters
+    #
+    def update_appointment(appointment_uuid, params={})
+      scope 'user_schedule'
+
+      put_one("schedule/appointments", appointment_uuid, params)
+    end    
+
+    private
+      # Returns a standard User-Agent string to be passed along with all requests
+      def user_agent
+        "pokitdok-ruby 0.8 #{RUBY_DESCRIPTION}"
+      end
+
+      # Returns a standard set of headers to be passed along with all requests
+      def headers
+        { 'User-Agent' => user_agent }
+      end
+
+      def get(endpoint, params = {})
+        response = current_scope.get(endpoint, headers: headers, params: params)
+
+        JSON.parse(response.body)
+      end
+
+      def get_one(endpoint, id, params = {})
+        response = current_scope.get("#{endpoint}/#{id}", headers: headers,
+                                 body: params.to_json) do |request|
+          request.headers['Content-Type'] = 'application/json'
+        end
+
+        JSON.parse(response.body)
+      end
+
+      def post(endpoint, params = {})
+        response = current_scope.post(endpoint, headers: headers,
+                               body: params.to_json) do |request|
+          request.headers['Content-Type'] = 'application/json'
+        end
+
+        JSON.parse(response.body)
+      end
+
+      def put_one(endpoint, id, params = {})
+        response = current_scope.put("#{endpoint}/#{id}", headers: headers,
+                                 body: params.to_json) do |request|
+          request.headers['Content-Type'] = 'application/json'
+        end
+
+        JSON.parse(response.body)
+      end
+
+      def delete_one(endpoint, id, params = {})
+        response = current_scope.delete("#{endpoint}/#{id}", headers: headers,
+                                 body: params.to_json) do |request|
+          request.headers['Content-Type'] = 'application/json'
+        end
+
+        if response.body.empty?
+          response.status == 204
+        else
+          JSON.parse(response.body)
+        end
+      end
+      
+      # Refreshes the client token associated with this PokitDok connection
+      #
+      # FIXME: automatic refresh on expiration
+      #
+      def refresh_token(code=nil)
+        body = {}
+        body[:code] = code unless code.nil?
+
+        @client.client_credentials.get_token(
+          headers: { 'Authorization' => 'Basic' })
+      end
+
+      def scope(name)
+        raise ArgumentError, "You need to provide an authorization code for " \
+          "the scope #{name} with the scope_code method" if @scopes[name].nil?
+
+        @current_scope = name
+
+        if @scopes[name][:scope].nil?
+          @scopes[name][:scope] = refresh_token(@scopes[name][:code])
+        end
+
+        @scopes[name][:scope]
+      end
+
+      def current_scope
+        @scopes[@current_scope][:scope]
+      end
+
+      def default_scope
+        @scopes['default'][:scope]
+      end
   end
 end