Ruby bindings for the AppDirect Vendor API. Provides oauth signed retrieval of AppDirect events. Intended for use with the AppDirect Subscription API
Please note this is NOT an offical library and is not endorsed or supported by AppDirect.
Add this line to your application's Gemfile:
gem 'appdirect'
And then execute:
$ bundle
Or install it yourself as:
$ gem install appdirect
The AppDirect API requires your own OAuth 1.0 Consumer Key and Secret. This is used to sign all get requests to the AppDirect REST API.
#config/initializers/appdirect.rb
AppDirect.consumer_key = "Dummy"
AppDirect.secret = "secret"
Subscription Management is intiated by a call from AppDirect to your defined callback urls. Part of this callback will include a URL parameter storing the URL for the event that you need to respond to.
For example you may have defined a callback URL as follows in your AppDirect integration settings
https://example.com/create?url={eventUrl}
Once you have retrieved the URL you can retrieve the Event:
url = "https://www.appdirect.com/rest/api/events/dummyOrder" # <-- this should be the url from the callback
event = AppDirect::Event.retrieve(url)
#Inspect the event
if event.type == "SUBSCRIPTION_CANCEL"
puts "Bad news, somebody just cancelled!"
end
As part of the retrieval the XML representation of the event is converted to a Ruby object, exposing the child elements of the <event>
tag as methods on the event object.
In this SUBSCRIPTION_NOTICE XML example:
<event>
<flag>STATELESS</flag>
<marketplace>
<baseUrl>https://acme.appdirect.com</baseUrl>
<partner>ACME</partner>
</marketplace>
<payload>
<account>
<accountIdentifier>dummy-account</accountIdentifier>
<status>SUSPENDED</status>
</account>
<configuration/>
<notice>
<type>DEACTIVATED</type>
</notice>
</payload>
<type>SUBSCRIPTION_NOTICE</type>
</event>
You can access the information as follows:
event = AppDirect::Event.retrieve(url)
event.flag # STATELESS
event.payload.account.status # SUSPENDED
event.type # SUBSCRIPTION_NOTICE
- Fork it ( https://github.com/timrwilliams/appdirect/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request