Class: Mushikago::Tombo::Client

Inherits:
Http::Client show all
Defined in:
lib/mushikago/tombo/client.rb

Overview

Tomboサービスを利用する

Examples:

client = Mushikago::Tombo::Client.new(:api_key => '<api_key>', :secret_key => '<secret_key>')

client.capture('http://www.tombo.ne.jp/', :thumbnail => true, :tags => ['tombo', 'webservice'])

captures = client.captures
captures['images'].each do |image|
  puts image['image_url']
end

APIキーをファイルから読み込む場合 

Mushikago.config.load(YAML.load(File.read('config.yml')))
client = Mushikago::Tombo::Client.new

Instance Attribute Summary

Attributes inherited from Http::Client

api_key, signer, use_ssl

Instance Method Summary (collapse)

Methods inherited from Http::Client

#initialize, #send_request

Constructor Details

This class inherits a constructor from Mushikago::Http::Client

Instance Method Details

- (Mushikago::Http::Response) capture(url, options = {})

指定したURLのキャプチャを取得する

Examples:

client.capture('http://www.tombo.ne.jp/', :thumbnail => true, :tags => ['tombo', 'webservice'])

Parameters:

  • url (String) —

    キャプチャ対象のURL

  • options (Hash) (defaults to: {}) —

    リクエストのオプション

Options Hash (options):

  • :image_format('jpg') (String) —

    画像のフォーマット(jpg,png)

  • :image_quality(80) (Integer) —

    画像の品質(0-100)

  • :thumbnail(0) (Boolean) —

    サムネイル取得フラグ(false:取得しない,true:取得する)

  • :tags (String, Array) —

    タグ

  • :delay_time (Integer) —

    キャプチャ取得までの遅延時間(0-20000)[ミリ秒]

Returns:



32
33
34
35
 
# File 'lib/mushikago/tombo/client.rb', line 32

def capture url, options={}
  request = CaptureRequest.new(url, options)
  send_request(request)
end

- (Mushikago::Http::Response) captures(options = {})

いままでキャプチャした画像の情報を取得する

Examples:

client.captures(:tag => 'webservice')

Parameters:

  • options (Hash) (defaults to: {}) —

    リクエストのオプション

Options Hash (options):

  • :id (String) —

    画像のID

  • :domain (String) —

    指定したドメインの画像一覧を取得する

  • :tag (String) —

    指定したタグの画像一覧を取得する

  • :limit(10) (Integer) —

    最大取得件数(1-100)

  • :offset(0) (Integer) —

    取得オフセット

Returns:



48
49
50
51
 
# File 'lib/mushikago/tombo/client.rb', line 48

def captures options={}
  request = CapturesRequest.new(options)
  send_request(request)
end

- (Mushikago::Http::Response) delete(id, options = {})

指定した画像を削除する

Examples:

client.delete('5a6cdfa3-xxx3-47d6-8xxx-5f83af6b66cc')

Parameters:

  • id (String) —

    画像のID

  • options (Hash) (defaults to: {}) —

    リクエストのオプション

Returns:



60
61
62
63
 
# File 'lib/mushikago/tombo/client.rb', line 60

def delete id, options={}
  request = DeleteRequest.new(id, options)
  send_request(request)
end

- (Mushikago::Http::Response) info(options = {})

APIの使用状況を取得する

Examples:

client.info

Parameters:

  • options (Hash) (defaults to: {}) —

    リクエストのオプション

Returns:



71
72
73
74
 
# File 'lib/mushikago/tombo/client.rb', line 71

def info options={}
  request = InfoRequest.new(options)
  send_request(request)
end