Ruby

Installation

Add this line to your application's Gemfile:
gem 'promptjoy-ruby'
And then execute:
bundle install
Or install it yourself as:
gem install promptjoy-ruby

Usage

require 'promptjoy-ruby'
client = PromptjoyRuby::Client.new('your_api_key')
You can find the API you want to interact with by using its URL. You can find the URL in the endpoint field of the API's page:
api = client.find_by_api_url('https://api.promptjoy.com/api/id')
You can also just find the API by its id:
api = client.find('id')
To call the API, pass in the data as a Hash:
response = api.call({
key1: 'value1',
key2: 'value2'
})

Example

The following example uses PromptJoy to build an API that recommends an open-source software package based on a problem to be solved: https://promptjoy.com/apis/jNqC7A
> require 'promptjoy-ruby'
> client = PromptjoyRuby::Client.new('***********************')
> api = client.find_by_api_url('https://api.promptjoy.com/api/jNqC7A')
> response = api.call({problem: "queue processing in ruby"})
> puts response
{"software"=>"Sidekiq", "reason"=>"Efficient and reliable background processing
for Ruby", "github_url"=>"https://github.com/mperham/sidekiq"}

Error Handling

If an error occurs during an API call, an instance of PromptjoyRuby::Error is raised with a message indicating the nature of the error.
begin
api.call(some_data)
rescue PromptjoyRuby::Error => e
puts "An error occurred: #{e.message}"
end