Skip to content

controlshift/action_kit_rest

Repository files navigation

action_kit_rest

A ruby binding for the ActionKit REST API

CI Status

Usage

ak = ActionKitRest.new(host: 'roboticdogs.actionkit.com', username: 'name', password: 'pass')
ak.import_page.create(title: "Title", name: "name")
ak.import_page.list.each do | page |
  puts page.name
end

With eventmachine:

ak = ActionKitRest.new(host: 'roboticdogs.actionkit.com', username: 'name', password: 'pass', adapter: :em_synchrony)

Languages

Get language by id and inspect it's iso code.

language = ak.language.get '1'
language.iso_code

Unsubscribe

# First create a page
page = ak.unsubscribe_page.create(title: "Unsubscribe from API", name: "api_unsubscribes")
# page is now a page object
puts "created page: #{page.id}"

# create an unsubscribe action on the page we just created.
unsub = ak.unsubscribe_action.create(email: 'foo@bar.com', page: 'api_unsubscribes')

# unsub is now an action object with info about the unsub we just processed.

Event Campaign Page

# Can send any of the attributes described at the schema (https://roboticdogs.actionkit.com/rest/v1/campaign/schema/) plus a collection of tag URIs to
# apply to the event create and event signup pages
event_campaign = ak.event_campaign_page.create(name: 'global-march-2015', title: 'Global March 2015', event_pages_tags: ["/rest/v1/tag/1/", "/rest/v1/tag/99/"])

# The event_campaign object will include all the fields detailed on the schema plus the ID (as an integer, not as a URI) of the associated pages:
# * event_create_page_name
# * event_signup_page_name

Event Create Action

Use this action for retrieving the eventcreateaction details (see the schema at: https://roboticdogs.actionkit.com/rest/v1/eventcreateaction/schema/). NOTE: Cannot create actions through this resource, instead POST on /rest/v1/action/ with the page being an eventcreatepage for creating a new action of this type.

Event

Use this object for retrieving and updating an existing event. For creating new events must POST an action on an eventcreatepage.

Event Signup Action

Use this action for retrieving the eventsignup details (see the schema at: https://roboticdogs.actionkit.com/rest/v1/eventsignupaction/schema/). NOTE: Cannot create actions through this resource, instead POST on /rest/v1/action/ with the page being an eventsignuppage for creating a new action of this type.

Event Signup

Use this object for retrieving and updating an event attendee. For creating new attendees must POST an action on an eventsignuppage.

Releasing

  • bump the version (update the appropriate file and add a git tag)
  • do a gem build, which will build a .gem file with the version number in the filename
  • do a gem push of that gem file you just built. You'll need to be a gem owner to do this.

Copyright

Copyright (c) 2013 ControlShift Ltd. See LICENSE.txt for further details.