rev-ruby-sdk

Background

Rev.com provides transcription and translation services powered by humans. The Rev.com API allows you to tap these services with no manual steps. It's a RESTful API, documented at http://www.rev.com/api/docs.

The Ruby SDK for the Rev API provides a convenient Ruby wrapper for the Rev.com API. All operations of the API, as described at http://www.rev.com/api/operations, are supported.

Install

gem install rev-api

or put it into your Gemfile.

When you need it:

require 'rev-api'

Authentication

If you are building a new API client, you must first obtain a client API key, which you can do at http://www.rev.com/api.

All operations in the API are performed on behalf of a Rev customer, identified by their user API key. The client key / user key pair is used to authenticate each API operation. Once you have the two keys, you can create a new Rev.com API client:

require 'rev-api'

rev_client = Rev.new('your_client_key', 'your_user_key')

You can read more about authentication in the Rev.com API at http://www.rev.com/api/security

Sandbox

All operations can be executed against either the production or the sandbox environment. The sandbox environment allows you to test your API client without actually paying for orders and having them worked on.

By default, the Rev.com API client executes against the production environment. To go against the sandbox instead, initialize the client this way:

require 'rev-api'

rev_client = Rev.new('your_client_key', 'your_user_key', Rev::Api::SANDBOX_HOST)

Usage

The snippets below assume you've initialized rev_client:

rev_client = Rev.new('your_client_key', 'your_user_key')

Listing orders

orders_page = rev_client.get_orders_page(1); # get a single page of orders
all_orders = rev_client.get_all_orders; # get first page of orders history

Get a single order by order number

some_order = rev_client.get_order('TCxxxxxxxx')
puts "Original comment: #{some_order.comments.first.text}"

Cancel an order given an order number

rev_client.cancel_order('TCxxxxxxxx')

Print out the text of all transcripts in an order

order = rev_client.get_order('TCxxxxxxx')

order.transcripts.each do |t|
    puts rev_client.get_attachment_content_as_string t.id
    puts
end

Refer to cli.rb in the examples directory for a full example illustrating placing orders, handling error responses, etc.

Documentation

YARD documentation can be generated by running rake yard command, and will be placed in the doc directory.

You can find API documentation at http://www.rev.com/api/docs.

Support

If you have any questions or suggestions for improvement, email us directly at api[at]rev[dot]com.

Compatibility

  • MRI 1.9.3
  • MRI 2.0.0

Tests

Minitest suite might be run using rake test command. Current stack:

  • minitest
  • webmock
  • vcr
  • turn

Dependencies

  • httparty