Ruby client for the Zendesk V2 API using cistern and faraday
Add this line to your application's Gemfile:
gem 'zendesk2'
Or install it yourself as:
$ gem install zendesk2
Default credentials will be read in from ~/.zendesk2
file in YAML format.
---
:subdomain: zendeskdev
:username: [email protected]
:password: wickedsecurepassword
:token: reallylongrandomstringprovidedbyzendesk
Either the absolute url or the subdomain is required. Username and either password or token are always required.
Zendesk2::Client.new(subdomain: "engineyard", username: "orchestra", password: "gwoo")
=> #<Zendesk2::Client::Real:0x007f99da1f9430 @url="https://engineyard.zendesk.com/api/v2", @username="orchestra", @password="gwoo", …>
or
Zendesk2::Client.new(url: "http://support.cloud.engineyard.com", username: "mate", token: "asdfghjkl1qwertyuiop5zxcvbnm3")
=> #<Zendesk2::Client::Real:0x007fd1bae486b0 @url="http://support.cloud.engineyard.com", @username="mate", @token="asdfghjkl1qwertyuiop5zxcvbnm3", …>
Currently support resources
- Audit Events
- Categories
- Forums
- Groups
- Organization
- Ticket Audits
- Tickets
- Topic Comments
- Topics
- User Identities
- Users
All collection are accessed like so:
client.users.all
=> <Zendesk2::Client::Users
count=1779,
next_page_link="https://dev.zendesk.com/api/v2/users.json?page=2",
previous_page_link=nil
[
<Zendesk2::Client::User
id=125394183,
url="https://dev.zendesk.com/api/v2/users/125394183.json",
...
>
]
Collections also respond to create
and new
client.users.create(email: "[email protected]", name: "lulz")
=> <Zendesk2::Client::User
id=234020811,
...
url="https://engineyarddev.zendesk.com/api/v2/users/234020811.json",
...
email="[email protected]",
>
client.users.new(email: "[email protected]")
=> <Zendesk2::Client::User
id=nil,
...
url=nil,
...
email="[email protected]",
...
>
Paged collections respond to next_page
and previous_page
when appropriate. page_size
and page
can be passed directly to the collection to control size and index.
page = client.users.all("per_page" => 1, "page" => 4)
=> <Zendesk2::Client::Users
count=1780,
next_page_link="https://dev.zendesk.com/api/v2/users.json?page=5&per_page=1",
previous_page_link="https://dev.zendesk.com/api/v2/users.json?page=3&per_page=1"
[
<Zendesk2::Client::User
id=217761652,
url="https://dev.zendesk.com/api/v2/users/217761652.json",
external_id=nil,
name="Guy Dude",
...
>
]
page.next_page
=> <Zendesk2::Client::Users
count=1780,
next_page_link="https://dev.zendesk.com/api/v2/users.json?page=6&per_page=1",
previous_page_link="https://dev.zendesk.com/api/v2/users.json?page=4&per_page=1"
[
<Zendesk2::Client::User
id=217761742,
url="https://dev.zendesk.com/api/v2/users/217761742.json",
...
name="epitaphical osteofibrous",
...
>
]
page.previous_page
=> <Zendesk2::Client::Users
count=1780,
next_page_link="https://dev.zendesk.com/api/v2/users.json?page=5&per_page=1",
previous_page_link="https://dev.zendesk.com/api/v2/users.json?page=3&per_page=1"
[
<Zendesk2::Client::User
id=217761652,
url="https://dev.zendesk.com/api/v2/users/217761652.json",
...
name="Guy Dude",
...
>
]
All models respond to destroy
and save
if applicable. save
performs a 'create' operation if there is no identity provided or an 'update' if there is an identity.
Zendesk2::Client::Ticket.new.save # performs a create
Zendesk2::Client::Ticket.new(id: 1).save # performs an update
Attributes can be enumerated by the attributes
method.
$ bundle exec rspec
Run against a real Zendesk installation by setting MOCK_ZENDESK=false
$ MOCK_ZENDESK=false bundle exec rspec
Credentials are sourced from your ~/.zendesk2
file
Raw responses and requests can be echoed to STDOUT by adding VERBOSE=true
$ VERBOSE=true bundle exec rspec
$ gem install gem-release
$ gem bump -trv (major|minor|patch)
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request