OVH-REST

OVH-REST is a (really) tiny, unofficial helper library OVH management API, wrapping the authentication parts and simplifying interaction in Ruby programs.

You need an appKey and an appSecret to use it, which can be obtained there.

Usage

First, you need to generate a consumerKey which is grants access to specific methods and parts of the API.

require 'ovh/rest'

access = {
  "accessRules" => [
    { "method" => "GET", "path" => "/sms/*" },
    { "method" => "POST", "path" => "/sms/*" },
    { "method" => "PUT", "path" => "/sms/*" },
    { "method" => "DELETE", "path" => "/sms/*" },
  ]
}

OVH::REST.generate_consumer_key("your_appKey", access)
=> {
  "validationUrl" => "https://www.ovh.com/fr/cgi-bin/api/requestCredential.cgi?credentialToken=XXXXXXXXXXXXXXXXXXXXXXX",
  "consumerKey" => "ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ",
  "state" => "pendingValidation"
}

You now have your consumerKey, which needs validation before use. Validation is done by following the validationUrl and entering your credentials.

Then you can use API features:

require 'ovh/rest'

ovh = OVH::REST.new(apiKey, appSecret, consumerKey)

# Get sms account status
result = ovh.get("/sms/sms-xx12345-1")

puts JSON.pretty_generate(result)
=>
{
  "status": "enable",
  "creditsLeft": 42,
  "name": "sms-xx12345-1",
  "userQuantityWithQuota": 0,
  "description": "",
[...]
}

# Send sms
result = ovh.post("/sms/sms-xx12345-1/jobs", {
  "charset" => "UTF-8",
  "class" => "phoneDisplay",
  "coding" => "7bit",
  "priority" => "high",
  "validityPeriod" => 2880
  "message" => "Dude! Disk is CRITICAL!",
  "receivers" => ["+12345678900", "+12009876543"],
  "sender" => "+12424242424",
})

puts JSON.pretty_generate(result)
=>
{
  "totalCreditsRemoved": 2,
  "ids": [
    12345,
    12346
  ]
}

All methods and parameters are described on the API documentation

Change API URL

It's possible to change the API url according to where your OVH account is located. To change the API url for generate_consumer_key use something like this:

OVH::REST.generate_consumer_key("your_appKey", access, 'https://ca.api.ovh.com/1.0')

Or, for calling other methods:

ovh = OVH::REST.new(apiKey, appSecret, consumerKey, 'https://ca.api.ovh.com/1.0')

Setup

Only tested with MRI >= 1.9.3

Dependencies: none

Install:

Introduction, in french: http://www.ovh.com/fr/g934.premiers-pas-avec-l-api