Project

sk_sdk

0.01
Low commit activity in last 3 years
No release in over a year
Connect your business with SalesKing. This gem gives ruby developers a jump-start for building SalesKing Business Apps. It provides classes to handle oAuth, make RESTfull API requests and parses JSON Schema
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0

Runtime

 Project Readme

SalesKing SDK¶ ↑

Automate your workflow’s by integrating and connecting your business with SalesKing. This Ruby Software-Development-Kit provides solid and handy tools for building SalesKing App’s(using oAuth2) and API clients.

Install¶ ↑

gem install sk_sdk

Dependencies (gem’s):

  • activesupport

  • activeresource v3.1+ (v3.0.10 until sk_sdk v0.0.8)

  • httparty

  • sk_api_schema

Classes¶ ↑

All classes must be explicitly required so each can be used on their own.

require 'sk_sdk/signed_request'
require 'sk_sdk/oauth'
require 'sk_sdk/base'
require 'sk_sdk/sync'

API client¶ ↑

Uses ActiveResource to CRUD SalesKing object’s see usage in README

oAuth¶ ↑

Get an oAuth2 access token and create oAuth related URL’s. There also is an omniAuth strategy.

De/encoding of signed_request parameter on canvas pages and PubSub/Webhook callbacks.

Sync¶ ↑

Map & Synchronize fields of a local with an remote object. Tackles the problem of normalizing objects to match internal data structures. Synchronization is done by a field-mapping and also sports transition methods for each way.

Usage¶ ↑

Read specs: github.com/salesking/sk_sdk/tree/master/spec/sk_sdk

Tests¶ ↑

Before you run the tests install required gems via bundler. We are providing several Gemfiles because of different patches for active_resource v2 vs v3. This definitly sucks, but as long as we stay with ARes we need to ensure it is working with every version.

Before running the specs, add your SalesKing credentials to /spec/settings.yml

cp spec/settings.yml.default spec/settings.yml

# test with most recent ARes version
bundle install
rake spec

#test with ActiveResource 3
BUNDLE_GEMFILE=ci/Gemfile_ar3 bundle install
BUNDLE_GEMFILE=ci/Gemfile_ar3 bundle exec rake spec

#test with ActiveResource 5
BUNDLE_GEMFILE=ci/Gemfile_ar5 bundle install
BUNDLE_GEMFILE=ci/Gemfile_ar5 bundle exec rake spec

Copyright © 2011-2022 Georg Leciejewski, released under the MIT license