Traitify
Traitify is a ruby gem wrapper for Traitify's Personality API
Installation
Add this line to your Gemfile (using bundler):
gem "traitify"
Or install it yourself with:
gem install traitify
Usage
The Traitify Client supports dynamically creating resource routes as seen in the examples below. Alternatively, HTTP methods (get, post, put, delete, path) can be used directly.
It is helpful to configure Traitify, otherwise everytime you create a Traitify object you must add the configuration options.
Configuration
All the configuration options can be found in lib/traitify/configuration.rb
Traitify.configure do |traitify|
traitify.host = "https://api-sandbox.traitify.com"
traitify.version = "v1"
traitify.secret_key = "secret"
traitify.public_key = "public" # Optional
traitify.deck_id = "deck-uuid" # Optional
traitify.image_pack = "image-pack-type" # Optional
traitify.locale_key = "en-us" # Optional
end
With config file:
traitify = Traitify.new
traitify.assessments.create
Without config file:
traitify = Traitify.new(
host: "https://api-sandbox.traitify.com",
version: "v1",
secret_key: "secret",
deck_id: "deck-uuid"
)
traitify.assessments.create
Auto Retry
Requests that fail can be automatically retried.
Retry Configuration
Retrying can be configured in multiple ways.
Through the general config:
Traitify.configure do |traitify|
traitify.auto_retry = true
traitify. =
end
traitify = Traitify.new
assessment = traitify.assessments("assessment-uuid").data
On a specific request:
traitify = Traitify.new
assessment = traitify.retriable().assessments("assessment-uuid").data
Or with both:
Traitify.configure do |traitify|
traitify.auto_retry = false
traitify. =
end
traitify = Traitify.new
assessment = traitify.retriable.assessments("assessment-uuid").data
This allows fine tuned control when and what to retry.
Retry Options
The options are passed to the Faraday Retry middleware. Supported options can be found in their documentation.
= {
methods: [:get, :post],
retry_statuses: [429, 500]
}
Decks
Getting all the decks:
decks = traitify.decks.data
Returns an array of Deck objects:
deck = decks.first
deck.id #=> "deck-uuid"
deck.name #=> "Career"
deck.description #=> "Description of deck"
# And more
Assessments
Creating an assessment:
assessment = traitify.assessments.create
You must can specify the deck in your configuration or override it here
assessment = traitify.assessments.create(deck_id: "deck-uuid")
You can optionally specify image pack or locale
assessment = traitify.assessments.create(image_pack: "full-color")
Returns an assessment object:
data = assessment.data
data.id #=> "assessment-uuid"
data.deck_id #=> "deck-uuid"
data.created_at #=> Returns time in Epoch format
data.completed_at #=> nil
Finding an assessment:
assessment = traitify.assessments("assessment-uuid").data
Returns an assessment object as seen above
Taking an assessment:
An assessment can be taken through our javascript plugin or by getting the slides and iterating through them
Finding an assessment's slides:
= traitify.assessments("assessment-uuid")..data
Returns an array of slides
Updating an assessment's slides:
.map! do ||
# true for me, false for not me
.response = true
# Pass in the time it took to make that choice (milliseconds)
.time_taken = 600
end
traitify.assessments("assessment-uuid")..update()
Updating a single assessment slide:
= assessment..data.first
.response = true
.time_taken = 600
traitify.assessments(assessment.id).(.id).update(.to_h)
Results
Getting an assessment's results
results = traitify.assessments("assessment-uuid").personality_types.data
Returns a results object:
results.personality_blend #=> Personality blend object
results.personality_types #=> Array of personality type objects (with scores)
personality_blend = results.personality_blend
personality_blend.personality_type_1 #=> Personality type object
personality_blend.personality_type_2 #=> Personality type object
personality_blend.name #=> "Visionary Creator"
personality_blend.description #=> "Visionary Creator description"
personality_blend.compliments #=> "Visionary Creator compliments"
personality_blend.conflicts #=> "Visionary Creator conflicts"
type = results.personality_types.first
type.score #=> 100
personality_type = type.personality_type
personality_type.name #=> "Creator"
personality_type.description #=> "Creator description"
personality_type.badge #=> Badge object
badge = personality_type.badge
badge.image_small #=> "http://s3.amazonaws.com/traitify-api/badges/creator/flat/small"
badge.image_medium #=> "http://s3.amazonaws.com/traitify-api/badges/creator/flat/medium"
badge.image_large #=> "http://s3.amazonaws.com/traitify-api/badges/creator/flat/large"
Getting an assessment's personality traits
traits = traitify.assessments("assessment-uuid").personality_traits.data
trait = traits.first
trait.score #=> 100
personality_trait = trait.personality_trait
personality_trait.name #=> "Imaginative"
personality_trait.definition #=> "Able to think symbolically and play with ideas."
personality_trait.description #=> "Coming Soon"
Getting an assessment's analytics
traits = traitify.analytics.decks("deck-uuid").personality_traits.data
types = traitify.analytics.decks("deck-uuid").personality_types.data
assessments = traitify.analytics.decks("deck-uuid").assessments.data
Getting a profile
profile = traitify.profiles("profile-uuid").data
profile.first_name #=> "John"
profile.last_name #=> "Doe"
profile.email #=> "[email protected]"
Creating a profile
profile = traitify.profiles.create({
first_name: "John",
last_name: "Doe",
email: "[email protected]"
}).data
profile.first_name #=> "John"
profile.last_name #=> "Doe"
profile.email #=> "[email protected]"
More results
More API endpoints may be available. You can find more at app.traitify.com/developer.