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

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

指定した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)

  • :user_agent (String) —

    ユーザエージェント

  • :display_width (Integer) —

    仮想ブラウザの幅(120-2560)

Returns:



34
35
36
37
 
# File 'lib/mushikago/tombo/client.rb', line 34

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

#captures(options = {}) ⇒ Mushikago::Http::Response

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

Examples:

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

Parameters:

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

    リクエストのオプション

Options Hash (options):

  • :id (String) —

    画像のID

  • :domain (String) —

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

  • :tag (String) —

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

  • :source_url (String) —

    指定した取得元URLの画像一覧を取得する

  • :state (String) —

    キャプチャの取得状態を取得する

  • :limit(10) (Integer) —

    最大取得件数(1-100)

  • :offset(0) (Integer) —

    取得オフセット

Returns:



52
53
54
55
 
# File 'lib/mushikago/tombo/client.rb', line 52

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

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

指定した画像を削除する

Examples:

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

Parameters:

  • id (String) —

    画像のID

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

    リクエストのオプション

Returns:



64
65
66
67
 
# File 'lib/mushikago/tombo/client.rb', line 64

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

#info(options = {}) ⇒ Mushikago::Http::Response

APIの使用状況を取得する

Examples:

client.info

Parameters:

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

    リクエストのオプション

Returns:



75
76
77
78
 
# File 'lib/mushikago/tombo/client.rb', line 75

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