bitly 2.1.0 → 3.1.0

data/lib/bitly/api/client.rb

@@ -58,7 +58,7 @@ module Bitly
 
       ##
       # Shortens a long URL.
-      # [`POST /v4/shorten`](https://dev.bitly.com/v4/#operation/createBitlink)
+      # [`POST /v4/shorten`](https://dev.bitly.com/api-reference/#createBitlink)
       #
       # @example
       #     client.shorten(long_url: "http://example.com")
@@ -75,7 +75,7 @@ module Bitly
 
       ##
       # Creates a Bitlink with more options than #shorten.
-      # [`POST /v4/bitlinks`](https://dev.bitly.com/v4/#operation/createFullBitlink)
+      # [`POST /v4/bitlinks`](https://dev.bitly.com/api-reference/#createFullBitlink)
       #
       # @example
       #     bitlink = client.create_bitlink(long_url: "http://example.com", title: "An example")
@@ -96,7 +96,7 @@ module Bitly
 
       ##
       # Return information about a bitlink
-      # [`GET /v4/bitlink/{bitlink}`](https://dev.bitly.com/v4/#operation/getBitlink)
+      # [`GET /v4/bitlink/{bitlink}`](https://dev.bitly.com/api-reference/#getBitlink)
       #
       # @example
       #     bitlink = client.bitlink(bitlink: "bit.ly/example")
@@ -110,7 +110,7 @@ module Bitly
 
       ##
       # Return public information about a bitlink.
-      # [`POST /v4/expand`](https://dev.bitly.com/v4/#operation/expandBitlink)
+      # [`POST /v4/expand`](https://dev.bitly.com/api-reference/#expandBitlink)
       #
       # @example
       #     bitlink = client.expand(bitlink: "bit.ly/example")
@@ -124,7 +124,7 @@ module Bitly
 
       ##
       # Returns a list of Bitlinks sorted by clicks.
-      # [`GET /v4/groups/{group_guid}/bitlinks/{sort}`](https://dev.bitly.com/v4/#operation/getSortedBitlinks)
+      # [`GET /v4/groups/{group_guid}/bitlinks/{sort}`](https://dev.bitly.com/api-reference/#getSortedBitlinks)
       #
       # The API returns a separate list of the links and the click counts, but
       # this method assigns the number of clicks for each link to the Bitlink
@@ -169,7 +169,7 @@ module Bitly
 
       ##
       # Update a Bitlink.
-      # [`PATCH /v4/bitlink/{bitlink}`](https://dev.bitly.com/v4/#operation/updateBitlink)
+      # [`PATCH /v4/bitlink/{bitlink}`](https://dev.bitly.com/api-reference/#updateBitlink)
       #
       # The parameters listed below are from the documentation. Some only work
       # if you have a Bitly Pro account.
@@ -225,7 +225,7 @@ module Bitly
 
       ##
       # Get the clicks for a bitlink.
-      # [`GET /v4/bitlink/{bitlink}/clicks`](https://dev.bitly.com/v4/#operation/getClicksForBitlink)
+      # [`GET /v4/bitlink/{bitlink}/clicks`](https://dev.bitly.com/api-reference/#getClicksForBitlink)
       #
       # @param bitlink [String] The Bitlink for which you want the clicks
       # @param sort [String] The data to sort on. Default and only option is
@@ -253,7 +253,7 @@ module Bitly
 
       ##
       # Get a list of organizations from the API.
-      # [`GET /v4/organizations`](https://dev.bitly.com/v4/#operation/getOrganizations)
+      # [`GET /v4/organizations`](https://dev.bitly.com/api-reference/#getOrganizations)
       #
       # @example
       #     organizations = client.organizations
@@ -265,7 +265,7 @@ module Bitly
 
       ##
       # Retrieve an organization from the API.
-      # [`GET /v4/organizations/{organization_guid}`](https://dev.bitly.com/v4/#operation/getOrganization)
+      # [`GET /v4/organizations/{organization_guid}`](https://dev.bitly.com/api-reference/#getOrganization)
       #
       # @example
       #     organization = client.organization(organization_guid: guid)
@@ -279,7 +279,7 @@ module Bitly
 
       ##
       # Shorten counts by organization
-      # [`GET /v4/organizations/{organization_guid}/shorten_counts`](https://dev.bitly.com/v4/#operation/getOrganizationShortenCounts)
+      # [`GET /v4/organizations/{organization_guid}/shorten_counts`](https://dev.bitly.com/api-reference/#getOrganizationShortenCounts)
       #
       # @example
       #     shorten_counts = client.organization_shorten_counts(organization_guid: organization_guid)
@@ -294,7 +294,7 @@ module Bitly
 
       ##
       # Gets the authorized user from the API.
-      # [`GET /v4/user`](https://dev.bitly.com/v4/#operation/getUser)
+      # [`GET /v4/user`](https://dev.bitly.com/api-reference/#getUser)
       #
       # @example
       #     user = client.user
@@ -306,7 +306,7 @@ module Bitly
 
       ##
       # Allows you to update the authorized user's name or default group guid.
-      # [`PATCH /v4/user`](https://dev.bitly.com/v4/#operation/updateUser)]
+      # [`PATCH /v4/user`](https://dev.bitly.com/api-reference/#updateUser)]
       #
       # @example
       #     client.update_user(name: "New Name", default_group_guid: "aaabbb")
@@ -322,7 +322,7 @@ module Bitly
 
       ##
       # Lists groups the authorized user can see.
-      # [`GET /v4/groups`](https://dev.bitly.com/v4/#operation/getGroups)
+      # [`GET /v4/groups`](https://dev.bitly.com/api-reference/#getGroups)
       #
       # @example
       #     groups = client.groups
@@ -337,7 +337,7 @@ module Bitly
 
       ##
       # Fetch a particular group.
-      # [`GET /v4/groups/{group_guid}`](https://dev.bitly.com/v4/#operation/getGroup)
+      # [`GET /v4/groups/{group_guid}`](https://dev.bitly.com/api-reference/#getGroup)
       #
       # @example
       #     group = client.group(guid)
@@ -351,7 +351,7 @@ module Bitly
 
       ##
       # Fetch the shorten counts for a group.
-      # [`GET /v4/groups/{group_guid}/shorten_counts`](https://dev.bitly.com/v4/#operation/getGroupShortenCounts)
+      # [`GET /v4/groups/{group_guid}/shorten_counts`](https://dev.bitly.com/api-reference/#getGroupShortenCounts)
       #
       # @example
       #     shorten_counts = client.group_shorten_counts(guid: group_guid)
@@ -366,7 +366,7 @@ module Bitly
 
       ##
       # Fetch a group's preferences.
-      # [`GET /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/v4/#operation/getGroupPreferences)
+      # [`GET /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/api-reference/#getGroupPreferences)
       #
       # @param group_guid [String] The group's guid
       #
@@ -377,7 +377,7 @@ module Bitly
 
       ##
       # Update a group's preferences.
-      # [`PATCH /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/v4/#operation/updateGroupPreferences)
+      # [`PATCH /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/api-reference/#updateGroupPreferences)
       #
       # @param group_guid [String] The group's guid
       # @param domain_preference [String] The new domain preference for this
@@ -391,7 +391,7 @@ module Bitly
 
       ##
       # Allows you to update a group's name, organization or BSDs.
-      # [`PATCH /v4/groups/{group_guid}`](https://dev.bitly.com/v4/#operation/updateGroup)
+      # [`PATCH /v4/groups/{group_guid}`](https://dev.bitly.com/api-reference/#updateGroup)
       #
       # @example
       #     client.update_group(group_guid: group_guid, name: "New Name", organization_guid: "aaabbb")
@@ -413,7 +413,7 @@ module Bitly
 
       ##
       # Retrieve a list of bitlinks by group
-      # [`GET /v4/groups/{group_guid}/bitlinks`](https://dev.bitly.com/v4/#operation/getBitlinksByGroup)
+      # [`GET /v4/groups/{group_guid}/bitlinks`](https://dev.bitly.com/api-reference/#getBitlinksByGroup)
       #
       # @example
       #     bitlinks = client.group_bitlinks(group_guid: guid)
@@ -484,22 +484,9 @@ module Bitly
         )
       end
 
-      ##
-      # Deletes a group.
-      # [`DELETE /v4/groups/{group_guid}`](https://dev.bitly.com/v4/#operation/deleteGroup)
-      #
-      # @example
-      #     client.delete_group(group_guid: group_guid)
-      #
-      # @return [Nil]
-      def delete_group(group_guid:)
-        group = Group.new(data: { "guid" => group_guid }, client: self)
-        group.delete
-      end
-
       ##
       # Gets the referring networks for the group.
-      # [`GET /v4/groups/{group_guid}/referring_networks`](https://dev.bitly.com/v4/#operation/GetGroupMetricsByReferringNetworks)
+      # [`GET /v4/groups/{group_guid}/referring_networks`](https://dev.bitly.com/api-reference/#GetGroupMetricsByReferringNetworks)
       #
       # @param group_guid [String] The guid of the group
       # @param unit [String] A unit of time. Default is "day" and can be
@@ -525,7 +512,7 @@ module Bitly
 
       ##
       # Gets the country click metrics for the group.
-      # [`GET /v4/groups/{group_guid}/countries`](https://dev.bitly.com/v4/#operation/getGroupMetricsByCountries)
+      # [`GET /v4/groups/{group_guid}/countries`](https://dev.bitly.com/api-reference/#getGroupMetricsByCountries)
       #
       # @param group_guid [String] The guid of the group
       # @param unit [String] A unit of time. Default is "day" and can be
@@ -551,7 +538,7 @@ module Bitly
 
       ##
       # Fetch Branded Short Domains (BSDs).
-      # [`GET /v4/bsds`](https://dev.bitly.com/v4/#operation/getBSDs)
+      # [`GET /v4/bsds`](https://dev.bitly.com/api-reference/#getBSDs)
       #
       # @example
       #     bsds = client.bsds
@@ -562,15 +549,15 @@ module Bitly
       end
 
       ##
-      # Fetch OAuth application by client ID
-      # [`GET /v4/apps/{client_id}`)](https://dev.bitly.com/v4/#operation/getOAuthApp)
-      #
+      # Fetch a qr code by ID
+      # [`GET /v4/qr-codes/{qrcode_id}`](https://dev.bitly.com/api-reference/#getQRCodeByIdPublic)
+      # 
       # @example
-      #     app = client.oauth_app(client_id: "client_id")
-      #
-      # @return Bitly::API::OAuthApp
-      def oauth_app(client_id:)
-        OAuthApp.fetch(client: self, client_id: client_id)
+      #    qrcode = client.qrcode(qrcode_id: "a1b2c3")
+      #    
+      # @return [Bitly::API::Qrcode]
+      def qrcode(qrcode_id:)
+        Qrcode.fetch(client: self, qrcode_id: qrcode_id)
       end
 
       private

data/lib/bitly/api/group/preferences.rb

@@ -33,7 +33,7 @@ module Bitly
         ##
         # Creates a new Bitly::API::Group::Preferences object from the data,
         # API client and optional response.
-        # [`GET /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/v4/#operation/getGroupPreferences)
+        # [`GET /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/api-reference/#updateGroupPreferences)
         #
         # @example
         #     preferences = Bitly::API::Group::Preferences.new(data: data, client: client)
@@ -49,7 +49,7 @@ module Bitly
 
         ##
         # Updates the preferences via the API
-        # [`PATCH /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/v4/#operation/updateGroupPreferences)
+        # [`PATCH /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/api-reference/#updateGroupPreferences)
         #
         # @example
         #     preferences.update(domain_preference: 'bit.ly')

data/lib/bitly/api/group.rb

@@ -21,7 +21,7 @@ module Bitly
       # Get a list of groups from the API. It receives an authorized
       # `Bitly::API::Client` object and uses it to request the `/groups`
       # endpoint, optionally passing an organization guid.
-      # [`GET /v4/groups`](https://dev.bitly.com/v4/#operation/getGroups)
+      # [`GET /v4/groups`](https://dev.bitly.com/api-reference/#getGroups)
       #
       # @example
       #     groups = Bitly::API::Group.list(client: client)
@@ -44,7 +44,7 @@ module Bitly
       # Retrieve a group from the API. It receives an authorized
       # `Bitly::API::Client` object and a group guid and uses it to request
       #  the `/groups/:group_guid` endpoint.
-      # [`GET /v4/groups/{group_guid}`](https://dev.bitly.com/v4/#operation/getGroup)
+      # [`GET /v4/groups/{group_guid}`](https://dev.bitly.com/api-reference/#getGroup)
       #
       # @example
       #     group = Bitly::API::Group.fetch(client: client, guid: guid)
@@ -93,7 +93,7 @@ module Bitly
 
       ##
       # Fetch the organization for the group.
-      # [`GET /v4/organizations/{organization_guid}`)](https://dev.bitly.com/v4/#operation/getOrganization)
+      # [`GET /v4/organizations/{organization_guid}`)](https://dev.bitly.com/api-reference/#getOrganization)
       #
       # @return [Bitly::API::Organization]
       def organization
@@ -102,7 +102,7 @@ module Bitly
 
       ##
       # Fetch the group's preferences.
-      # [`GET /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/v4/#operation/getGroupPreferences)
+      # [`GET /v4/groups/{group_guid}/preferences`](https://dev.bitly.com/api-reference/#getGroupPreferences)
       #
       # @return [Bitly::API::Group::Preferences]
       def preferences
@@ -111,7 +111,7 @@ module Bitly
 
       ##
       # Fetch the group's tags
-      # [`GET /v4/groups/{group_guid}/tags`](https://dev.bitly.com/v4/#operation/getGroupTags)
+      # [`GET /v4/groups/{group_guid}/tags`](https://dev.bitly.com/api-reference/#getGroupTags)
       #
       # @return [Array<String>]
       def tags
@@ -123,7 +123,7 @@ module Bitly
       # If you update the organization guid and have already loaded the
       # organization, it is nilled out so it can be reloaded with the correct
       # guid
-      # [`PATCH /v4/groups/{group_guid}`](https://dev.bitly.com/v4/#operation/updateGroup)
+      # [`PATCH /v4/groups/{group_guid}`](https://dev.bitly.com/api-reference/#updateGroup)
       #
       # @example
       #     group.update(name: "New Name", organization_guid: "aaabbb")
@@ -147,22 +147,9 @@ module Bitly
         self
       end
 
-      ##
-      # Deletes the group.
-      # [`DELETE /v4/groups/{group_guid}`](https://dev.bitly.com/v4/#operation/deleteGroup)
-      #
-      # @example
-      #     group.delete
-      #
-      # @return [Nil]
-      def delete
-        @response = @client.request(path: "/groups/#{guid}", method: "DELETE")
-        return nil
-      end
-
       ##
       # Get the shorten counts for the group.
-      # # [`GET /v4/groups/{group_guid}/shorten_counts`](https://dev.bitly.com/v4/#operation/getGroupShortenCounts)
+      # # [`GET /v4/groups/{group_guid}/shorten_counts`](https://dev.bitly.com/api-reference/#getGroupShortenCounts)
       #
       # @return [Bitly::API::ShortenCounts]
       def shorten_counts
@@ -171,16 +158,25 @@ module Bitly
 
       ##
       # Gets the Bitlinks for the group.
-      # [`GET /v4/groups/{group_guid}/bitlinks`](https://dev.bitly.com/v4/#operation/getBitlinksByGroup)
+      # [`GET /v4/groups/{group_guid}/bitlinks`](https://dev.bitly.com/api-reference/#getBitlinksByGroup)
       #
       # @return [Bitly::API::Bitlink::List]
       def bitlinks
         Bitly::API::Bitlink.list(client: @client, group_guid: guid)
       end
 
+      ##
+      # Gets the QR Codes for the group.
+      # [`GET /v4/groups/{group_guid}/qr-codes`](https://dev.bitly.com/api-reference/#listQRMinimal)
+      #
+      # @return [Bitly::API::Qrcode::List]
+      def qrcodes
+        Bitly::API::Qrcode.list_by_group(client: @client, group_guid: guid)
+      end
+
       ##
       # Gets the referring networks for the group.
-      # [`GET /v4/groups/{group_guid}/referring_networks`](https://dev.bitly.com/v4/#operation/GetGroupMetricsByReferringNetworks)
+      # [`GET /v4/groups/{group_guid}/referring_networks`](https://dev.bitly.com/api-reference/#GetGroupMetricsByReferringNetworks)
       #
       # @param unit [String] A unit of time. Default is "day" and can be
       #     "minute", "hour", "day", "week" or "month"
@@ -205,7 +201,7 @@ module Bitly
 
       ##
       # Gets the country click metrics for the group.
-      # [`GET /v4/groups/{group_guid}/countries`](https://dev.bitly.com/v4/#operation/getGroupMetricsByCountries)
+      # [`GET /v4/groups/{group_guid}/countries`](https://dev.bitly.com/api-reference/#getGroupMetricsByCountries)
       #
       # @param unit [String] A unit of time. Default is "day" and can be
       #     "minute", "hour", "day", "week" or "month"
@@ -229,4 +225,4 @@ module Bitly
       end
     end
   end
-end
+end

data/lib/bitly/api/organization.rb

@@ -18,7 +18,7 @@ module Bitly
       # Get a list of organizations from the API. It receives an authorized
       # `Bitly::API::Client` object and uses it to request the `/organizations`
       # endpoint.
-      # [`GET /v4/organizations`](https://dev.bitly.com/v4/#operation/getOrganizations)
+      # [`GET /v4/organizations`](https://dev.bitly.com/api-reference/#getOrganizations)
       #
       # @example
       #     organizations = Bitly::API::Organization.list(client: client)
@@ -38,7 +38,7 @@ module Bitly
       # Retrieve an organization from the API. It receives an authorized
       # `Bitly::API::Client` object and an organization guid and uses it to
       #  request the `/organizations/:organization_guid` endpoint.
-      # [`GET /v4/organizations/{organization_guid}`](https://dev.bitly.com/v4/#operation/getOrganization)
+      # [`GET /v4/organizations/{organization_guid}`](https://dev.bitly.com/api-reference/#getOrganization)
       #
       # @example
       #     organization = Bitly::API::Organization.fetch(client: client, organization_guid: guid)
@@ -90,7 +90,7 @@ module Bitly
 
       ##
       # Shorten counts by organization
-      # [`GET /v4/organizations/{organization_guid}/shorten_counts`](https://dev.bitly.com/v4/#operation/getOrganizationShortenCounts)
+      # [`GET /v4/organizations/{organization_guid}/shorten_counts`](https://dev.bitly.com/api-reference/#getOrganizationShortenCounts)
       #
       # @example
       #     shorten_counts = organization.shorten_counts

data/lib/bitly/api/paginated_list.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+require "cgi"
+require "uri"
+
+module Bitly
+  module API
+    class PaginatedList < Bitly::API::List
+      attr_reader :next_url, :prev_url, :size, :page, :total
+
+      def initialize(response: , client:)
+        @client = client
+        super(items: items_from_response(response: response), response: response)
+        if response.body["pagination"]
+          pagination = response.body["pagination"]
+          @next_url = pagination["next"]
+          @prev_url = pagination["prev"]
+          @size = pagination["size"]
+          @page = pagination["page"]
+          @total = pagination["total"]
+        end
+      end
+
+      def has_next_page?
+        !next_url.nil? && !next_url.empty?
+      end
+
+      def has_prev_page?
+        !prev_url.nil? && !prev_url.empty?
+      end
+
+      def next_page
+        has_next_page? ? get_page(uri: URI(next_url)) : nil
+      end
+
+      def prev_page
+        has_prev_page? ? get_page(uri: URI(prev_url)) : nil
+      end
+
+      def item_key
+        raise NotImplementedError
+      end
+
+      def item_factory(item)
+        raise NotImplementedError
+      end
+
+      private
+
+      def get_page(uri:)
+        response = @client.request(path: uri.path.gsub(/\/v4/, ""), params: CGI.parse(uri.query))
+        self.class.new(response: response, client: @client)
+      end
+
+      def items_from_response(response:)
+        response.body[item_key].map do |item|
+          item_factory(item)
+        end
+      end
+    end
+  end
+end

data/lib/bitly/api/qrcode/paginated_list.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+require_relative "../paginated_list"
+
+module Bitly
+  module API
+    class Qrcode
+      class PaginatedList < Bitly::API::PaginatedList
+        def item_key
+          "qr_codes"
+        end
+
+        def item_factory(data)
+          Qrcode.new(data: data, client: @client)
+        end
+      end
+    end
+  end
+end

data/lib/bitly/api/qrcode/scans_summary.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+require_relative "../base"
+
+module Bitly
+  module API
+    class Qrcode
+      class ScansSummary
+        include Base
+
+        def self.fetch(client:, qrcode_id:, unit: nil, units: nil, unit_reference: nil)
+          response = client.request(
+            path: "/qr-codes/#{qrcode_id}/scans/summary",
+            params: {
+              "unit" => unit,
+              "units" => units,
+              "unit_reference" => unit_reference
+            }
+          )
+          new(data: response.body, response: response)
+        end
+
+        def self.attributes
+          [:units, :unit, :unit_reference, :total_scans]
+        end
+        attr_reader(*attributes)
+
+        def initialize(data:, response: nil)
+          assign_attributes(data)
+          @response = response
+        end
+      end
+    end
+  end
+end

data/lib/bitly/api/qrcode.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require_relative "./base"
+require_relative "./list"
+
+module Bitly
+  module API
+    class Qrcode
+      autoload :PaginatedList, File.join(File.dirname(__FILE__), "qrcode/paginated_list.rb")
+      autoload :ScansSummary, File.join(File.dirname(__FILE__), "qrcode/scans_summary.rb")
+
+      include Base
+
+      class List < Bitly::API::List ; end
+
+      def self.attributes
+        [:qrcode_id, :title, :archived, :serialized_content, :long_urls, :bitlink_id, :qr_code_type, :render_customizations]
+      end
+      def self.time_attributes
+        [:created, :updated]
+      end
+      attr_reader(*(attributes + time_attributes))
+
+      ##
+      # Retrieves a list of QR codes matching the filter settings. Values are in reverse chronological order. The pagination occurs by calling the next link in the pagination response object.
+      # [`GET /v4/groups/{group_guid}/qr-codes`](https://dev.bitly.com/api-reference/#listQRMinimal)
+      #
+      # @example
+      #     qrcodes = Bitly::API::Qrcode.list(client: client, group_guid: guid)
+      #
+      # @param client [Bitly::API::Client] An authorized API client
+      # @param group_guid [String] The group guid for which you want qr codes
+      # @param size [Integer] The number of QR Codes to return, default 50.
+      # @param archived [String] Whether or not to include archived QRCodes.
+      #     One of "on", "off" or "both". Defaults to "off".
+      # @param archived [String] a filter value if the QRCode has any render customizations (like color or shape changes).
+      #     One of "on", "off" or "both". Defaults to "both".
+      #
+      # @return [Bitly::API::Qrcode::PaginatedList]
+      def self.list_by_group(
+        client:,
+        group_guid:,
+        size: nil,
+        archived: nil,
+        has_render_customizations: nil
+      )
+        params = {
+          "size" => size,
+          "archived" => archived,
+          "has_render_customizations" => has_render_customizations
+        }
+        response = client.request(path: "/groups/#{group_guid}/qr-codes", params: params)
+        PaginatedList.new(response: response, client: client)
+      end
+
+      ##
+      # Return information about a QR Code
+      # [`GET /v4/qr-codes/{qrcode_id}`](https://dev.bitly.com/api-reference/#getQRCodeByIdPublic)
+      #
+      # @example
+      #     qrcode = Bitly::API::Qrcode.fetch(client: client, qrcode_id: "a1b2c3")
+      #
+      # @param client [Bitly::API::Client] An authorized API client
+      # @param qrcode_id [String] The qrcode id you want information about
+      #
+      # @return [Bitly::API::Qrcode]
+      def self.fetch(client:, qrcode_id:)
+        response = client.request(path: "/qr-codes/#{qrcode_id}")
+        new(data: response.body, client: client, response: response)
+      end
+
+      # [`GET /v4/qr-codes/{qrcode_id}/scans/summary`](https://dev.bitly.com/api-reference/#getScanMetricsForQRCode)
+      #
+      # @return [Bitly::API::Qrcode::ScansSummary]
+      def scans_summary(unit: nil, units: nil, unit_reference: nil)
+        ScansSummary.fetch(client: @client, qrcode_id: @qrcode_id, unit: unit, units: units, unit_reference: unit_reference)
+      end
+
+      ##
+      # Return the SVG or PNG image of a QR Code
+      # [`GET /v4/qr-codes/{qrcode_id}/image`](https://dev.bitly.com/api-reference/#getQRCodeImagePublic)
+      #
+      # @param client [Bitly::API::Client] An authorized API client
+      # @param format [String] "svg" or "png". Default "svg"
+      #
+      # @return [String]
+      def image(format: nil)
+        params = format.nil? ? {} : {format: format}
+        response = @client.request(path: "/qr-codes/#{qrcode_id}/image", params: params)
+        response.body["qr_code_image"]
+      end
+
+      def initialize(data:, client:, response: nil)
+        assign_attributes(data)
+        @client = client
+        @response = response
+      end
+
+      def bitlink
+        Bitlink.fetch(client: @client, bitlink: @bitlink_id)
+      end
+    end
+  end
+end

data/lib/bitly/api/shorten_counts.rb

@@ -17,7 +17,7 @@ module Bitly
 
       ##
       # Shorten counts by group
-      # [`GET /v4/groups/{group_guid}/shorten_counts`](https://dev.bitly.com/v4/#operation/getGroupShortenCounts)
+      # [`GET /v4/groups/{group_guid}/shorten_counts`](https://dev.bitly.com/api-reference/#getGroupShortenCounts)
       #
       # @example
       #     shorten_counts = Bitly::API::ShortenCounts.by_group(client: client, group_guid: group_guid)
@@ -34,7 +34,7 @@ module Bitly
 
       ##
       # Shorten counts by organization
-      # [`GET /v4/organizations/{organization_guid}/shorten_counts`](https://dev.bitly.com/v4/#operation/getOrganizationShortenCounts)
+      # [`GET /v4/organizations/{organization_guid}/shorten_counts`](https://dev.bitly.com/api-reference/#getOrganizationShortenCounts)
       #
       # @example
       #     shorten_counts = Bitly::API::ShortenCounts.by_organization(client: client, organization_guid: organization_guid)

data/lib/bitly/api/user.rb

@@ -18,7 +18,7 @@ module Bitly
       include Base
       ##
       # Gets the authorized user from the API.
-      # [`GET /v4/user`](https://dev.bitly.com/v4/#operation/getUser)
+      # [`GET /v4/user`](https://dev.bitly.com/api-reference/#getUser)
       #
       # @example
       #     user = Bitly::API::User.fetch(client: client)
@@ -79,7 +79,7 @@ module Bitly
       # Allows you to update the authorized user's name or default group guid.
       # If you update the default group ID and have already loaded the default
       # group, it is nilled out so it can be reloaded with the correct ID.
-      # [`PATCH /v4/user`](https://dev.bitly.com/v4/#operation/updateUser)]
+      # [`PATCH /v4/user`](https://dev.bitly.com/api-reference/#updateUser).
       #
       # @example
       #     user.update(name: "New Name", default_group_guid: "aaabbb")

data/lib/bitly/api.rb

@@ -9,11 +9,11 @@ module Bitly
     autoload :Client, File.join(File.dirname(__FILE__), "api/client.rb")
     autoload :ClickMetric, File.join(File.dirname(__FILE__), "api/click_metric.rb")
     autoload :Bitlink, File.join(File.dirname(__FILE__), "api/bitlink.rb")
+    autoload :Qrcode, File.join(File.dirname(__FILE__), "api/qrcode.rb")
     autoload :Organization, File.join(File.dirname(__FILE__), "api/organization.rb")
     autoload :Group, File.join(File.dirname(__FILE__), "api/group.rb")
     autoload :User, File.join(File.dirname(__FILE__), "api/user.rb")
     autoload :BSD, File.join(File.dirname(__FILE__), "api/bsd.rb")
-    autoload :OAuthApp, File.join(File.dirname(__FILE__), "api/oauth_app.rb")
     autoload :ShortenCounts, File.join(File.dirname(__FILE__), "api/shorten_counts.rb")
   end
 end