Project

freshdesk

0.04
No commit activity in last 3 years
No release in over 3 years
Ruby Gem for interfacing with the Freshdesk API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

DEPRECATED: This gem only works with v1 of Freshdesk's API, which is no longer current.

freshdesk-api

A Ruby API client that interfaces with freshdesk.com web service. This client supports regular CRUD operation

Freshdesk's API docs are here http://freshdesk.com/api/

As of now, it supports the following:

  • tickets
  • users
  • forums
  • solutions
  • companies

Usage Example

client = Freshdesk.new("http://companyname.freshdesk.com/", "user@domain.com", "password")  
# note trailing slash in domain is required

client = Freshdesk.new("http://companyname.freshdesk.com/", "api key")
# simply leave out the password when specifiying the api key


response = client.get_users  
client.get_users 123  
client.post_users(:name => "test", :email => "test@143124test.com", :customer => "name")  
client.put_users(:id =>123, :name => "test", :email => "test@143124test.com", :customer => "name")  
client.delete_tickets 123  

# example of working with users
users = REXML::Document.new(client.get_users)
users.elements.each("users/user") { |u|
			puts u.elements['email'].text
			puts u.elements['id'].text
		}

GET request

client.get_tickets(id - optional)
client.get_user_ticket({:email => 'foo@example.com})
client.get_users(id - optional)
client.get_forums(id - optional)
client.get_solutions(id - optional)
client.get_companies(id - optional)

POST request

client.post_users(key1 => value, key2 => value2, ...)

# example posts a ticket
client.post_tickets(:email => "user@domain.com", :description => "test ticket from rails app", :name => "Customer Name", :source => 2, :priority => 2, :name => "Joshua Siler")
# etc.

DELETE request

client.delete_users(id - required)
# etc.

Authors

  • @dvliman
  • @tsmacdonald