API v2

CHANGELOG.md

@@ -1,3 +1,8 @@
+# 1.0.0
+
+* **Breaking** Library moved to use Patreon API v2 endpoints and calls
+* A good part of the code is now generated based on the Platform API's Cartographer schema definition.
+
 # 0.5.1
 
 * Fix test runner to execute tests properly

README.md

@@ -1,6 +1,14 @@
 # patreon-ruby
 Interact with the Patreon API via OAuth.
 
+## Important notice about updating to 1.0.0 from earlier versions
+
+Patreon Ruby library version 1.0.0 moves on to Patreon's v2 API, which is not compatible with old v1 calls. Therefore directly upgrading from older versions to 1.0.0 would break compatibility of your installation. APIv1 will be deprecated some time soon after APIv2 come out of beta, so its important to get your integration compatible with API v2. 
+
+For more information on the differences/similarities between v1 and v2 please check: https://docs.patreon.com/#what-39-s-new
+
+## Getting started
+
 Get the gem from [RubyGems](https://rubygems.org/gems/patreon)
 
 Step 1. Get your client_id and client_secret
@@ -38,22 +46,71 @@ end
 
 Step 3. (Optional) Customize your usage
 ---
-`Patreon::API` instances have four methods:
-* `fetch_user(includes=nil, fields=nil)`
-* `fetch_campaign(includes=nil, fields=nil)`
-* `fetch_campaign_and_patrons(includes=nil, fields=nil)`
-* `fetch_page_of_pledges(campaign_id, page_size, cursor=nil, includes=nil, fields=nil)`
+`Patreon::API` instances have the following methods:
+<!--
+This list is auto-generated from the same code that generates
+https://docs.patreon.com.
+-->
+* `get_campaigns(opts = { includes: [], fields: [],  count: 10, cursor: nil})`
+* `get_identity(opts = { includes: [], fields: [], })`
+* `get_webhooks(opts = { includes: [], fields: [],  count: 10, cursor: nil})`
+* `get_campaigns_by_id_members(resource_id, opts = { includes: [], fields: [],  count: 10, cursor: nil})`
+* `get_campaigns_by_id(resource_id, opts = { includes: [], fields: [], })`
+* `get_webhooks_by_id(resource_id, opts = { includes: [], fields: [], })`
+* `get_members_by_id(resource_id, opts = { includes: [], fields: [], })`
 
 The `includes` and `fields` arguments to these methods specify
 the [related resources](http://jsonapi.org/format/#fetching-includes)
 and the [resource attributes](http://jsonapi.org/format/#fetching-sparse-fieldsets)
 you want returned by our API, as per the [JSON:API specification](http://jsonapi.org/).
 The lists of valid `includes` and `fields` arguments are provided on `Patreon::Schemas`.
-For instance, if you wanted to request the total amount a patron has ever paid to your campaign,
-which is not included by default, you could do:
+
+For instance, if you wanted to request the first name and total amount a patron has ever paid to your campaign, you could do:
 ```ruby
 api_client = Patreon::API.new(patron_access_token)
-patron_response = api_client.fetch_user(nil, {
-  'pledge': Patreon::Schemas::Pledge.default_attributes + [Patreon::Schemas::Pledge::Attributes::TOTAL_HISTORICAL_AMOUNT_CENTS]
+
+User = Patreon::Schemas::User
+Member = Patreon::Schemas::Member
+
+patron_response = api_client.get_identity({
+    'includes': [User::Relationships::MEMBERSHIPS],
+    'fields': {
+        User::Name => User::Attributes::FIRST_NAME,
+        Member::Name => Member::Attributes::LIFETIME_SUPPORT_CENTS
+    }
 })
 ```
+Which would return:
+```json
+{
+    "data": {
+        "attributes": {
+            "first_name": "Jack"
+        },
+        "id": "1234",
+        "relationships": {
+            "memberships": {
+                "data": [
+                    {
+                        "id": "960d87e4-49ab-4828-b411-8ba9f91c6d81",
+                        "type": "member"
+                    }
+                ]
+            }
+        },
+        "type": "user"
+    },
+    "included": [
+        {
+            "attributes": {
+                "lifetime_support_cents": 500
+            },
+            "id": "960d87e4-49ab-4828-b411-8ba9f91c6d81",
+            "type": "member"
+        }
+    ],
+    "links": {
+        "self": "https://www.patreon.com/api/oauth2/v2/user/1234"
+    }
+}
+```

lib/patreon.rb

@@ -1,3 +1,7 @@
+# This file is auto-generated from the same code that generates
+# https://docs.patreon.com. Community pull requests against this
+# file may not be accepted.
+
 require 'net/http'
 require 'json'
 require 'rack'
@@ -8,11 +12,19 @@
 require 'patreon/utils/jsonapi/url_util'
 require 'patreon/utils/enum'
 require 'patreon/utils/client'
+require 'patreon/schemas/address'
+require 'patreon/schemas/benefit'
 require 'patreon/schemas/campaign'
+require 'patreon/schemas/deliverable'
 require 'patreon/schemas/goal'
-require 'patreon/schemas/pledge'
-require 'patreon/schemas/reward'
+require 'patreon/schemas/media'
+require 'patreon/schemas/member'
+require 'patreon/schemas/oauthclient'
+require 'patreon/schemas/pledgeevent'
+require 'patreon/schemas/post'
+require 'patreon/schemas/tier'
 require 'patreon/schemas/user'
+require 'patreon/schemas/webhook'
 require 'patreon/version'
 require 'patreon/oauth'
-require 'patreon/api'
+require 'patreon/api'

lib/patreon/api.rb

@@ -1,29 +1,55 @@
+# This file is auto-generated from the same code that generates
+# https://docs.patreon.com. Community pull requests against this
+# file may not be accepted.
+
 module Patreon
   class API
+    include Patreon::Utils::JSONAPI
+
     def initialize(access_token)
       @access_token = access_token
     end
+
+    def get_campaigns(opts = {})
+        base_url = "campaigns"
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields], opts[:count], opts[:cursor])
+        get_parse_json(url)
+    end
+
+    def get_identity(opts = {})
+        base_url = "identity"
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields])
+        get_parse_json(url)
+    end
+
+    def get_webhooks(opts = {})
+        base_url = "webhooks"
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields], opts[:count], opts[:cursor])
+        get_parse_json(url)
+    end
 
-    def fetch_user(opts = {})
-      get_parse_json(Utils::JSONAPI::URLUtil.build_url('current_user', opts[:includes], opts[:fields]))
+    def get_campaigns_by_id_members(resource_id, opts = {})
+        base_url = "campaigns/{}/members".gsub('{}', resource_id)
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields], opts[:count], opts[:cursor])
+        get_parse_json(url)
     end
 
-    def fetch_campaign(opts = {})
-      get_parse_json(Utils::JSONAPI::URLUtil.build_url('current_user/campaigns', opts[:includes], opts[:fields]))
+    def get_campaigns_by_id(resource_id, opts = {})
+        base_url = "campaigns/{}".gsub('{}', resource_id)
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields])
+        get_parse_json(url)
     end
 
-    def fetch_campaign_and_patrons(opts = {})
-      opts[:includes] = opts[:includes] ? Array(opts[:includes]) : []
-      opts[:includes].concat(Schemas::Campaign.default_relationships + [Schemas::Campaign::Relationships::PLEDGES])
-      fetch_campaign(opts)
+    def get_webhooks_by_id(resource_id, opts = {})
+        base_url = "webhooks/{}".gsub('{}', resource_id)
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields])
+        get_parse_json(url)
     end
 
-    def fetch_page_of_pledges(campaign_id, opts = {})
-      params = {}
-      params["page[count]"] = opts[:count] || 10
-      params["page[cursor]"] = opts[:cursor] if opts[:cursor]
-      url = "campaigns/#{campaign_id}/pledges?#{Rack::Utils.build_query(params)}"
-      get_parse_json(Patreon::Utils::JSONAPI::URLUtil.build_url(url, opts[:includes], opts[:fields]))
+    def get_members_by_id(resource_id, opts = {})
+        base_url = "members/{}".gsub('{}', resource_id)
+        url = URLUtil.build_url(base_url, opts[:includes], opts[:fields])
+        get_parse_json(url)
     end
 
     private
@@ -43,7 +69,7 @@ def get_json(suffix)
       #SECURITY HOLE
       http.set_debug_output($stdout) if ENV['DEBUG']
 
-      req = Net::HTTP::Get.new("/api/oauth2/api/#{suffix}")
+      req = Net::HTTP::Get.new("/api/oauth2/v2/#{suffix}")
       req['Authorization'] = "Bearer #{@access_token}"
       req['User-Agent'] = Utils::Client.user_agent_string
       http.request(req).body
@@ -53,4 +79,4 @@ def parse_json(json)
       JSON::Api::Vanilla.parse(json)
     end
   end
-end
+end

lib/patreon/schemas/address.rb

@@ -0,0 +1,32 @@
+# This file is auto-generated from the same code that generates
+# https://docs.patreon.com. Community pull requests against this
+# file may not be accepted.
+
+module Patreon
+  module Schemas
+    module Address
+      Name = 'address'
+
+      class Attributes
+        include Utils::Enum
+
+        define :ADDRESSEE, 'addressee'
+        define :LINE_1, 'line_1'
+        define :LINE_2, 'line_2'
+        define :POSTAL_CODE, 'postal_code'
+        define :CITY, 'city'
+        define :STATE, 'state'
+        define :COUNTRY, 'country'
+        define :PHONE_NUMBER, 'phone_number'
+        define :CREATED_AT, 'created_at'
+      end
+
+      class Relationships
+        include Utils::Enum
+
+        define :USER, 'user'
+        define :CAMPAIGNS, 'campaigns'
+      end
+    end
+  end
+end

lib/patreon/schemas/benefit.rb

@@ -0,0 +1,40 @@
+# This file is auto-generated from the same code that generates
+# https://docs.patreon.com. Community pull requests against this
+# file may not be accepted.
+
+module Patreon
+  module Schemas
+    module Benefit
+      Name = 'benefit'
+
+      class Attributes
+        include Utils::Enum
+
+        define :TITLE, 'title'
+        define :DESCRIPTION, 'description'
+        define :BENEFIT_TYPE, 'benefit_type'
+        define :RULE_TYPE, 'rule_type'
+        define :CREATED_AT, 'created_at'
+        define :DELIVERED_DELIVERABLES_COUNT, 'delivered_deliverables_count'
+        define :NOT_DELIVERED_DELIVERABLES_COUNT, 'not_delivered_deliverables_count'
+        define :DELIVERABLES_DUE_TODAY_COUNT, 'deliverables_due_today_count'
+        define :NEXT_DELIVERABLE_DUE_DATE, 'next_deliverable_due_date'
+        define :TIERS_COUNT, 'tiers_count'
+        define :IS_DELETED, 'is_deleted'
+        define :IS_PUBLISHED, 'is_published'
+        define :IS_ENDED, 'is_ended'
+        define :APP_EXTERNAL_ID, 'app_external_id'
+        define :APP_META, 'app_meta'
+      end
+
+      class Relationships
+        include Utils::Enum
+
+        define :TIERS, 'tiers'
+        define :DELIVERABLES, 'deliverables'
+        define :CAMPAIGN, 'campaign'
+        define :CAMPAIGN_INSTALLATION, 'campaign_installation'
+      end
+    end
+  end
+end