kentaa-api 0.4.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ebca7b73a3ae49b7d9948211b21638e7131340fe58f6b34551260853dd4b6fb
-  data.tar.gz: cc9a8b5450c1b4068867a2bf0eada220174e3d107ae2369ddbc5080bcf785257
+  metadata.gz: 1aca25f29280f1c8b1ac63c17a8d8bac967c27a10975027ceaa163ca13a57a09
+  data.tar.gz: 7e9a8a9e7bcc65b8f63de8284db9e8550d238bf75dc8565a2eeb5f147f48e5c3
 SHA512:
-  metadata.gz: 2815897919718da19a9ed6ddb05589523b492639427fced920168bb469c794a83c5cc4477f9dc3403e7a932f6d88d657035a741f5cb3a44c075807b88b3ccf0f
-  data.tar.gz: 696d64f0bf684fafcbf1c38c24f3f1b03c97312f2c6b666054464b85b58b0907eb27e8a42bffd4e886d035475daaab8e22354af9a39ce9ea9a54943fbd225962
+  metadata.gz: 5b5889b38da0cf1ed917460cfae3f2c4987c4fe62e48988f865dd1768c2106ca12d726e324f3d3c1f7199b8888848c93ecfcd93ff2a6de5bb6bff01a79418d9a
+  data.tar.gz: bd4b8963915d48a62f44082aa20225b1826c2a0eae40488084c138e78799f06787e7213d6d7bc8b2bd1e7f19de92f3ddbae7ad2e13ec6e2a47fb192d1187c57b

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017 Peter Postma
+Copyright (c) 2017-2021 Kentaa BV
 
 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/README.md

@@ -1,10 +1,34 @@
 # Kentaa API
 
 [![Gem Version](https://badge.fury.io/rb/kentaa-api.svg)](https://badge.fury.io/rb/kentaa-api)
-[![Build Status](https://travis-ci.org/KentaaNL/kentaa-api.svg?branch=master)](https://travis-ci.org/KentaaNL/kentaa-api)
+[![Build Status](https://github.com/KentaaNL/kentaa-api/actions/workflows/test.yml/badge.svg)](https://github.com/KentaaNL/kentaa-api/actions)
 [![Code Climate](https://codeclimate.com/github/KentaaNL/kentaa-api/badges/gpa.svg)](https://codeclimate.com/github/KentaaNL/kentaa-api)
 
-This gem provides a Ruby library for communicating with the [Kentaa API](https://api.kentaa.nl/v1/doc).
+This gem provides a Ruby library for communicating with the [Kentaa API](https://developer.kentaa.nl/kentaa-api/).
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Actions](#actions)
+  - [Companies](#companies)
+  - [Donation forms](#donation-forms)
+  - [Donations](#donations)
+  - [Manual donations](#manual-donations)
+  - [Newsletter subscriptions](#newsletter-subscriptions)
+  - [Performances](#performances)
+    - [Photos](#performance-photos)
+  - [Projects](#projects)
+  - [Recurring donors](#recurring-donors)
+  - [Segments](#segments)
+  - [Sites](#sites)
+  - [Teams](#teams)
+  - [Users](#users)
+  - [Pagination](#pagination)
+- [Error handling](#error-handling)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
 
 ## Installation
 
@@ -24,143 +48,468 @@ Or install it yourself as:
 
 ## Usage
 
-### Initialization
-
-Create the client with your API key:
+Create a Kentaa API client using your API key:
 
 ```ruby
 require 'kentaa/api'
 
-config = Kentaa::Api::Config.new('your_api_key')
-client = Kentaa::Api::Client.new(config)
+client = Kentaa::Api::Client.new(api_key: 'your_api_key')
 ```
 
-### Retrieving data
+The client is created for the production environment by default. If you want to use the testing environment, then add `test: true`:
 
-All endpoints use the same convention for retrieving data. The method `list` is for retrieving multiple resources. The method `get` is used for retrieving a single resource.
+```ruby
+client = Kentaa::Api::Client.new(api_key: 'your_api_key', test: true)
+```
 
-The `list` method on the endpoint returns an [Enumerable](https://ruby-doc.org/core/Enumerable.html) object:
+### Actions
 
 ```ruby
-actions = client.actions.list
-
-actions.each { |a| puts a.title }
-actions.first
+# List Actions
+actions = client.actions       # paginated
+actions = client.actions.all   # non-paginated
+
+actions.each do |action|
+  action.title  # => "Lorem ipsum"
+  action.url  # => "https://demo1.kentaa.nl/actie/john-doe"
+end
+
+# Get Action by ID or slug
+action = client.actions.get(1)
+action = client.actions.get("john-doe")
+
+action.title  # => "Lorem ipsum"
+action.url  # => "https://demo1.kentaa.nl/actie/john-doe"
+
+# Create a new Action
+action = client.actions.create(
+  title: "Lorem ipsum",
+  description: "Dolorum animi qui nihil iure dolore velit.",
+  owner_id: 1
+)
+
+action.id  # => 1
+action.title  # => "Lorem ipsum"
+action.description  # => "Dolorum animi qui nihil iure dolore velit."
+action.owner  # => Kentaa::Api::Resources::User
+
+# Update an Action
+action = client.actions.update(1, title: "Foobar")
+
+action.title  # => "Foobar"
 ```
 
-The results might be part of a paginated set. You can query the next page by doing:
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#actions) and [Kentaa::Api::Resources::Action](lib/kentaa/api/resources/action.rb) for all available properties.
+
+
+### Companies
 
 ```ruby
-actions = actions.next if actions.next_page?
+# List Companies
+companies = client.companies       # paginated
+companies = client.companies.all   # non-paginated
+
+companies.each do |company|
+  company.title  # => "Lorem ipsum"
+  company.url  # => "https://demo1.kentaa.nl/bedrijven/kentaa-bv"
+end
+
+# Get Company by ID or slug
+company = client.companies.get(1)
+company = client.companies.get("kentaa-bv")
+
+company.title  # => "Lorem ipsum"
+company.url  # => "https://demo1.kentaa.nl/bedrijven/kentaa-bv"
 ```
 
-See also `Kentaa::Api::Resources::List` for the available methods for pagination.
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#companies) and [Kentaa::Api::Resources::Company](lib/kentaa/api/resources/company.rb) for all available properties.
 
-The `all` method on the endpoint returns an [Enumerator](https://ruby-doc.org/core/Enumerator.html) and will iterate automatically through all pages to retrieve the requested data.
+### Donation forms
 
 ```ruby
-actions = client.actions.all
+# List Donation forms
+donation_forms = client.donation_forms       # paginated
+donation_forms = client.donation_forms.all   # non-paginated
+
+donation_forms.each do |form|
+  form.title  # => "Lorem ipsum dolor sit amet"
+  form.url  # => "https://demo1.kentaa.nl/form"
+end
+
+# Get Donation form
+form = client.donation_forms.get(1)
+
+form.title  # => "Lorem ipsum dolor sit amet"
+form.owner  # => Kentaa::Api::Resources::User
+form.url  # => "https://demo1.kentaa.nl/form"
+form.total_amount  # => BigDecimal("95.0")
+```
+
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#donation-forms) and [Kentaa::Api::Resources::DonationForm](lib/kentaa/api/resources/donation_form.rb) for all available properties.
+
+### Donations
 
-actions.each { |a| puts a.title }
-actions.first(100)
+```ruby
+# List Donations
+donations = client.donations       # paginated
+donations = client.donations.all   # non-paginated
+
+donations.each do |donations|
+  donation.first_name  # => "John"
+  donation.last_name  # => "Doe"
+end
+
+# Get Donation
+donation = client.donations.get(1)
+
+donation.first_name  # => "John"
+donation.last_name  # => "Doe"
+donation.amount  # => BigDecimal("15.0")
+donation.entity  # => Kentaa::Api::Resources::Site
 ```
 
-### Requests
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#donations) and [Kentaa::Api::Resources::Donation](lib/kentaa/api/resources/donation.rb) for all available properties.
+
+### Manual donations
 
-Below a summary of the supported requests per endpoint.
+```ruby
+# List Manual donations
+donations = client.manual_donations       # paginated
+donations = client.manual_donations.all   # non-paginated
+
+donations.each do |donations|
+  donation.first_name  # => "John"
+  donation.last_name  # => "Doe"
+end
+
+# Get Manual donation
+donation = client.manual_donations.get(1)
+
+donation.first_name  # => "John"
+donation.last_name  # => "Doe"
+donation.amount  # => BigDecimal("15.0")
+donation.entity  # => Kentaa::Api::Resources::Site
+
+# Create a Manual donation
+donation = client.manual_donations.create(
+  first_name: "John",
+  last_name: "Doe",
+  amount: "15.0"
+)
+
+donation.id  # => 1
+donation.first_name  # => "John"
+donation.last_name  # => "Doe"
+donation.amount  # => BigDecimal("15.0")
+donation.entity  # => Kentaa::Api::Resources::Site
+
+# Update a Manual donation
+donation = client.manual_donations.update(1, first_name: "Jane")
+
+donation.first_name  # => "Jane"
+
+# Delete a Manual donation
+client.manual_donations.delete(1)
+```
 
-#### Actions
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#manual-donations) and [Kentaa::Api::Resources::ManualDonation](lib/kentaa/api/resources/manual_donation.rb) for all available properties.
+
+### Newsletter subscriptions
 
 ```ruby
-actions = client.actions.list             # get actions (paginated)
-actions = client.actions.all              # get all actions (non-paginated)
+# List Newsletter subscriptions
+newsletter_subscriptions = client.newsletter_subscriptions       # paginated
+newsletter_subscriptions = client.newsletter_subscriptions.all   # non-paginated
+
+newsletter_subscriptions.each do |subscription|
+  subscription.email  # => "john.doe@kentaa.nl"
+  subscription.subscription_url  # => "https://demo1.kentaa.nl"
+end
 
-action = client.actions.get(1)            # query action by ID
-action = client.actions.get("john-doe")   # query action by slug
+# Get Newsletter subscription
+subscription = client.newsletter_subscriptions.get(1)
+
+subscription.email  # => "john.doe@kentaa.nl"
+subscription.subscription_url  # => "https://demo1.kentaa.nl"
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/actions).
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#newsletter-subscriptions) and [Kentaa::Api::Resources::NewsletterSubscription](lib/kentaa/api/resources/newsletter_subscription.rb) for all available properties.
+
+### Performances
 
-#### Donations
+Performances are available on an [Kentaa::Api::Resources::Action](lib/kentaa/api/resources/action.rb), so you first need to retrieve an Action.
 
 ```ruby
-donations = client.donations.list      # get donations (paginated)
-donations = client.donations.all       # get all donations (non-paginated)
+action = client.actions.get(1)
+
+# List Performances
+performances = action.performances       # paginated
+performances = action.performances.all   # non-paginated
+
+performances.each do |performance|
+  performance.title  # => "First tour"
+  performance.distance  # => BigDecimal("65.25")
+end
+
+# Get Performance
+donation = action.performances.get(1)
+
+performance.title  # => "First tour"
+performance.distance  # => BigDecimal("65.25")
 
-donation = client.donations.get(1)     # query donation by ID
+# Create a Performance
+performance = action.performances.create(
+  title: "First tour",
+  performance_type: "biking",
+  performance_at: Time.now,
+  distance: "65.25"
+)
+
+performance.title  # => "First tour"
+performance.distance  # => BigDecimal("65.25")
+
+# Update a Performance
+performance = action.performances.update(1, title: "Big tour")
+
+performance.title  # => "Big tour"
+
+# Delete a Performance
+action.performances.delete(1)
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/donations).
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#performances) and [Kentaa::Api::Resources::Performance](lib/kentaa/api/resources/performance.rb) for all available properties.
 
-#### Newsletter subscriptions
+#### Performance photos
 
 ```ruby
-newsletter_subscriptions = client.newsletter_subscriptions.list       # get newsletter subscriptions (paginated)
-newsletter_subscriptions = client.newsletter_subscriptions.all        # get all newsletter subscriptions (non-paginated)
+# List Performance photos
+photos = performance.photos       # paginated
+photos = performance.photos.all   # non-paginated
+
+photos.each do |photo|
+  photos.image_url  # => "https://d2a3ux41sjxpco.cloudfront.net/action_performance_photos/file/1/normal_8ce42aeb3bbb1b4964e621b42691f13d4dfa3f21.jpg"
+end
+
+# Get Performance photo
+photo = performance.photos.get(1)
+
+photo.image_url  # => "https://d2a3ux41sjxpco.cloudfront.net/action_performance_photos/file/1/normal_8ce42aeb3bbb1b4964e621b42691f13d4dfa3f21.jpg"
+
+# Create a Performance photo
+photo = performance.photos.create(
+  io: File.open("photo.jpeg"),
+  content_type: "image/jpeg"
+)
 
+photo.image_url  # => "https://d2a3ux41sjxpco.cloudfront.net/action_performance_photos/file/1/normal_8ce42aeb3bbb1b4964e621b42691f13d4dfa3f21.jpg"
+```
+
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#performances-photos) and [Kentaa::Api::Resources::PerformancePhoto](lib/kentaa/api/resources/performance_photo.rb) for all available properties.
+
+### Projects
 
-newsletter_subscriptions = client.newsletter_subscriptions.get(1)     # query newsletter subscription by ID
+```ruby
+# List Projects
+projects = client.projects       # paginated
+projects = client.projects.all   # non-paginated
+
+projects.each do |project|
+  project.title  # => "Dignissimos provident rerum enim alias magni asperna..."
+  project.target_amount  # => 250000
+end
+
+# Get Project by ID or slug
+project = client.projects.get(1)
+project = client.projects.get("project")
+
+project.title  # => "Dignissimos provident rerum enim alias magni asperna..."
+project.target_amount  # => 250000
+project.url  # => "https://demo1.kentaa.nl/project/dignissimos-provident"
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/newsletter-subscriptions).
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#projects) and [Kentaa::Api::Resources::Project](lib/kentaa/api/resources/project.rb) for all available properties.
 
-#### Projects
+### Recurring donors
 
 ```ruby
-projects = client.projects.list            # get projects (paginated)
-projects = client.projects.all             # get all projects (non-paginated)
+# List Recurring donors
+recurring_donors = client.recurring_donors       # paginated
+recurring_donors = client.recurring_donors.all   # non-paginated
+
+recurring_donors.each do |recurring_donor|
+  recurring_donor.first_name  # => "John"
+  recurring_donor.last_name  # => "Doe"
+end
+
+# Get Recurring donor
+recurring_donor = client.recurring_donors.get(1)
+
+recurring_donor.first_name  # => "John"
+recurring_donor.last_name  # => "Doe"
+recurring_donor.amount  # => BigDecimal("15.0")
+recurring_donor.entity  # => Kentaa::Api::Resources::DonationForm
+```
 
-project = client.projects.get(1)           # query project by ID
-project = client.projects.get("project")   # query project by slug
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#recurring-donors) and [Kentaa::Api::Resources::RecurringDonor](lib/kentaa/api/resources/recurring_donor.rb) for all available properties.
+
+### Segments
+
+```ruby
+# List Segments
+segments = client.segments       # paginated
+segments = client.segments.all   # non-paginated
+
+segments.each do |segment|
+  segment.name  # => "Segment 2"
+  segment.url  # => "https://segment-2.demo1.kentaa.nl/"
+end
+
+# Get Segment
+segment = client.segments.get(1)
+
+segment.name  # => "Segment 2"
+segment.title  # => "Aut est maxime nostrum."
+segment.url  # => "https://segment-2.demo1.kentaa.nl/"
+segment.target_amount  # => 2685
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/projects).
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#segments) and [Kentaa::Api::Resources::Segment](lib/kentaa/api/resources/segment.rb) for all available properties.
+
+### Sites
 
-#### Segments
+The only method here is `current`, since there is only one site per API key.
 
 ```ruby
-segments = client.segments.list       # get segments (paginated)
-segments = client.segments.all        # get all segments (non-paginated)
+# Get current Site
+site = client.sites.current
 
-segment = client.segments.get(1)      # query segment by ID
+site.title  # => "Aut est maxime nostrum."
+site.description  # => "Maiores ut velit fugiat eos. Quae est nostrum rerum aut et nihil. Sequi eveniet occaecati et est corporis et enim."
+site.url  # => "https://demo1.kentaa.nl/"
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/segments).
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#sites) and [Kentaa::Api::Resources::Site](lib/kentaa/api/resources/site.rb) for all available properties.
 
-#### Sites
+### Teams
 
-The only method here is `current`, since there is only one site.
+```ruby
+# List Teams
+teams = client.teams       # paginated
+teams = client.teams.all   # non-paginated
+
+teams.each do |team|
+  team.name  # => "Asperiores beatae voluptate qui."
+  team.url  # => "https://demo1.kentaa.nl/team/asperiores-beatae-voluptate-qui"
+end
+
+# Get Team by ID or slug
+team = client.teams.get(1)
+team = client.teams.get("team")
+
+team.name  # => "Asperiores beatae voluptate qui."
+team.url  # => "https://demo1.kentaa.nl/team/asperiores-beatae-voluptate-qui"
+team.total_amount  # => BigDecimal("225.0")
+```
+
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#teams) and [Kentaa::Api::Resources::Team](lib/kentaa/api/resources/team.rb) for all available properties.
+
+### Users
 
 ```ruby
-site = client.sites.current    # get the current site
+# List Users
+users = client.users       # paginated
+users = client.users.all   # non-paginated
+
+users.each do |user|
+  user.first_name  # => "John"
+  user.last_name  # => "Doe"
+end
+
+# Get User
+user = client.users.get(1)
+
+user.first_name  # => "John"
+user.last_name  # => "Doe"
+
+# Create an User
+user = client.users.create(
+  first_name: "John",
+  last_name: "Doe"
+)
+
+user.id  # => 1
+user.first_name  # => "John"
+user.last_name  # => "Doe"
+
+# Update an User
+user = client.users.update(1, first_name: "Jane")
+
+user.first_name  # => "Jane"
+
+# Authenticate an User
+user = client.users.auth(email: "john.doe@kentaa.nl", password: "secret")
+
+user.id  # => 1
+user.first_name  # => "John"
+user.last_name  # => "Doe"
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/sites).
+See also the [Kentaa API docs](https://developer.kentaa.nl/kentaa-api/#users) and [Kentaa::Api::Resources::User](lib/kentaa/api/resources/user.rb) for all available properties.
+
+### Pagination
 
-#### Teams
+All List actions return paginated results in an [Enumerable](https://ruby-doc.org/core/Enumerable.html) object. The default page size is 25, but you can can customize this by setting the `per_page` parameter.
 
 ```ruby
-teams = client.teams.list          # get teams (paginated)
-teams = client.teams.all           # get all teams (non-paginated)
+actions = client.actions(per_page: 100)
 
-team = client.teams.get(1)         # query team by ID
-team = client.teams.get("team")    # query team by slug
+actions.each do |action|
+  action.title  # => "Lorem ipsum"
+  action.url  # => "https://demo1.kentaa.nl/actie/john-doe"
+end
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/teams).
+You can iterate through the pages using the `.next` method and checking the result. For example:
+
+```ruby
+actions = client.actions
+
+loop do
+  actions.each do |action|
+    # Do something with actions
+  end
 
+  actions = actions.next
+  break if actions.nil?
+end
+```
 
-#### Users
+The `all` method on the endpoint returns a lazy [Enumerator](https://ruby-doc.org/core/Enumerator.html) and will automatically iterate through all pages and retrieve the requested data.
 
 ```ruby
-users = client.users.list          # get users (paginated)
-users = client.users.all           # get all users (non-paginated)
+actions = client.actions.all
 
-user = client.users.get(1)         # query user by ID
+actions.each do |action|
+  action.title  # => "Lorem ipsum"
+  action.url  # => "https://demo1.kentaa.nl/actie/john-doe"
+end
 ```
 
-See also the [Kentaa API docs](https://api.kentaa.nl/v1/doc/users).
+See [Kentaa::Api::Resources::List](lib/kentaa/api/resources/list.rb) for all available pagination methods.
+
+## Error handling
 
+All responses that are not HTTP status 20x will result in a [Kentaa::Api::RequestError](lib/kentaa/api/exception.rb).
+
+```ruby
+begin
+  client.actions.get("invalid")
+rescue Kentaa::Api::RequestError => e
+  e.message  # => "404: Requested resource was not found."
+  e.http_code  # => 404
+  e.errors  # => Array[Kentaa::Api::Resources::Error]
+end
+```
 
 ## Development
 
@@ -176,4 +525,3 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/Kentaa
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-

data/lib/kentaa/api/client.rb

@@ -3,44 +3,56 @@
 module Kentaa
   module Api
     class Client
-      def initialize(config)
-        @config = config
+      def initialize(options = {})
+        @config = Kentaa::Api::Config.new(options)
       end
 
-      def actions
-        Kentaa::Api::Clients::Actions.new(@config)
+      def actions(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::Action, endpoint_path: '/actions'))
       end
 
-      def donations
-        Kentaa::Api::Clients::Donations.new(@config)
+      def companies(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::Company, endpoint_path: '/companies'))
       end
 
-      def manual_donations
-        Kentaa::Api::Clients::ManualDonations.new(@config)
+      def donations(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::Donation, endpoint_path: '/donations'))
       end
 
-      def newsletter_subscriptions
-        Kentaa::Api::Clients::NewsletterSubscriptions.new(@config)
+      def donation_forms(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::DonationForm, endpoint_path: '/donation-forms'))
       end
 
-      def projects
-        Kentaa::Api::Clients::Projects.new(@config)
+      def manual_donations(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: '/manual-donations'))
       end
 
-      def segments
-        Kentaa::Api::Clients::Segments.new(@config)
+      def newsletter_subscriptions(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: '/newsletter-subscriptions'))
       end
 
-      def sites
-        Kentaa::Api::Clients::Sites.new(@config)
+      def projects(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::Project, endpoint_path: '/projects'))
       end
 
-      def teams
-        Kentaa::Api::Clients::Teams.new(@config)
+      def recurring_donors(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::RecurringDonor, endpoint_path: '/recurring-donors'))
       end
 
-      def users
-        Kentaa::Api::Clients::Users.new(@config)
+      def segments(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::Segment, endpoint_path: '/segments'))
+      end
+
+      def sites(options = {})
+        Kentaa::Api::Resources::Sites.new(@config, options)
+      end
+
+      def teams(options = {})
+        Kentaa::Api::Resources::List.new(@config, options.merge(resource_class: Kentaa::Api::Resources::Team, endpoint_path: '/teams'))
+      end
+
+      def users(options = {})
+        Kentaa::Api::Resources::Users.new(@config, options)
       end
     end
   end