growi-client 0.9.0

data/growi-client.gemspec

@@ -0,0 +1,40 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "growi/client/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "growi-client"
+  spec.version       = Growi::Client::VERSION
+  spec.authors       = ["Ryu Sato"]
+  spec.email         = ["ryu@weseek.co.jp"]
+
+  spec.summary       = %q{Client of growi}
+  spec.description   = %q{growi-client is client of growi with use API.}
+  spec.homepage      = "https://github.com/ryu-sato/growi-client"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    #spec.metadata["allowed_push_host"] = "http://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.15"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rspec-json_matcher", "~> 0.1"
+
+  spec.add_dependency "rest-client", "~> 2.0"
+  spec.add_dependency "json", "~> 2.1"
+end

data/lib/growi-client.rb

@@ -0,0 +1 @@
+require 'growi/client/client'

data/lib/growi/client/apireq/api_request_attachments.rb

@@ -0,0 +1,140 @@
+require_relative 'api_request_base'
+
+# 添付ファイル一覧リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/attachment.js
+class GApiRequestAttachmentsList < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/attachments.list', METHOD_GET, { page_id: param[:page_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :get, url: entry_point, headers: { params: @param } }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    attachments = []
+    ret['attachments'].each do |attachment|
+      attachments.push(GrowiAttachment.new(attachment))
+    end
+    return GApiReturn.new(ok: ret['ok'], data: attachments)
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:page_id])
+      CPInvalidRequest.new 'Parameter page_id is required.'
+    end
+  end
+
+end
+
+# 添付ファイル追加リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/attachment.js
+class GApiRequestAttachmentsAdd < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/attachments.add', METHOD_POST,
+          { page_id: param[:page_id], file: param[:file] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+    if invalid?
+      return validation_msg
+    end
+    params = {
+      method: :post,
+      url:    entry_point,
+      payload: {
+        access_token: @param[:access_token],
+        page_id:      @param[:page_id],
+        file:         @param[:file]
+      }
+    }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:file] && @param[:page_id])
+      CPInvalidRequest.new 'Parameters file and page_id are required.'
+    end
+  end
+
+end
+
+
+# 添付ファイル削除リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/attachment.js
+class GApiRequestAttachmentsRemove < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/attachments.remove', METHOD_POST,
+          { attachment_id: param[:attachment_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :post, url: entry_point,
+               payload: @param.to_json,
+               headers: { content_type: :json, accept: :json }
+             }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: nil)
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:attachment_id])
+      CPInvalidRequest.new 'Parameter attachment_id is required.'
+    end
+  end
+
+end
+

data/lib/growi/client/apireq/api_request_base.rb

@@ -0,0 +1,106 @@
+# APIリクエストのバリデーションエラー
+# @note rescue する必要はないので Exception クラスは継承しない
+class CPInvalidRequest
+  attr_reader :msg
+
+  # コンストラクタ
+  # @param [String] msg エラーメッセージ（原因と対策が分かるとよい）
+  def initialize(msg)
+    @msg = msg
+  end
+
+  # Convert string
+  # @return [String] Message
+  def to_s
+    return @msg
+  end
+end
+
+# APIリクエストの応答基本クラス
+class GApiReturn
+  attr_accessor :ok, :data
+
+  # Constractor
+  # @param [String] ok Result of API
+  def initialize(params = {})
+    if (! params[:ok].is_a?(TrueClass) && ! params[:ok].is_a?(FalseClass))
+      raise ArgumentError.new('Parameter ok is needed true or false.')
+    end
+    @ok = params[:ok]
+    @data = params[:data]
+  end
+
+end
+
+# APIリクエストの基本クラス
+class GApiRequestBase
+  METHOD_GET = "GET"
+  METHOD_POST = "POST"
+  attr_reader :entry_point, :method, :param
+
+  # コンストラクタ
+  # @param [String] entry_point APIリクエストのエントリポイントとなるURLパス(ex. '/page.list')
+  # @param [Enumerator] method APIリクエストのタイプ
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(entry_point, method, param = {})
+    @entry_point = entry_point
+    @method = method
+    @param = param.reject { |k, v| !v }
+  end
+
+  # パラメータを代入
+  # @param [Hash] param APIリクエストのパラメータ
+  def param=(param = {})
+    @param = param
+  end
+
+  # パラメータのバリデーションチェックを行う
+  # @return [true/false] バリデーションチェック結果
+  def valid?
+    return (!_invalid)
+  end
+
+  # パラメータのバリデーションチェックを行う
+  # @return [true/false] バリデーションチェック結果
+  def invalid?
+    return (_invalid)
+  end
+
+  # バリデーションエラーの説明
+  # @return [String] バリデーションエラーの説明
+  def validation_msg
+    return _invalid&.to_s
+  end
+
+  # リクエストを実行する
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [String] リクエスト実行結果（GApiReturnオブジェクト）
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+
+    case @method
+    when 'GET'
+      params = { method: :get, url: entry_point, headers: { params: @param } }.merge(rest_client_param)
+    when 'POST'
+      params = { method: :post, url: entry_point, content_type: :json, accept: :json,
+                 headers: { params: @param.to_json } }.merge()
+    end
+    ret_json = RestClient::Request.execute params
+    ret = JSON.parse(ret_json)
+    return GApiReturn.new(ok: ret['ok'], data: ret.reject { |k,v| k == 'ok' })
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    return CPInvalidRequest "Invalid API request.";
+  end
+
+end
+

data/lib/growi/client/apireq/api_request_pages.rb

@@ -0,0 +1,421 @@
+require_relative 'api_request_base'
+require 'growi/client/model/growi_page'
+
+# ページ一覧リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestPagesList < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/pages.list', METHOD_GET,
+          { path: param[:path_exp], user: param[:user] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+
+    params = { method: :get, url: entry_point, headers: { params: @param } }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    pages = []
+    ret['pages'].each do |page|
+      pages.push(GrowiPage.new(page))
+    end
+    return GApiReturn.new(ok: ret['ok'], data: pages)
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:path] || @param[:user])
+      return CPInvalidRequest.new 'Parameter path or user is required.'
+    end
+    if (@param[:path] && @param[:user])
+      return CPInvalidRequest.new 'Parameter path and user can not be specified both.'
+    end
+  end
+
+end
+
+
+# ページ取得リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestPagesGet < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/pages.get', METHOD_GET,
+          { page_id: param[:page_id], 
+            path: param[:path], revision_id: param[:revision_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :get, url: entry_point, headers: { params: @param } }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:path] || @param[:page_id]) 
+      return CPInvalidRequest.new 'Parameter path or page_id is required.'
+    end
+  end
+
+end
+
+
+# ページ作成リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestPagesCreate < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/pages.create', METHOD_POST,
+          { body: param[:body], path: param[:path], grant: param[:grant] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+
+    params = { method: :post, url: entry_point,
+               payload: @param.to_json,
+               headers: { content_type: :json, accept: :json }
+             }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:body] && @param[:path]) 
+      return CPInvalidRequest.new 'Parameters body and path are required.'
+    end
+  end
+
+end
+
+# ページ更新リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestPagesUpdate < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/pages.update', METHOD_POST,
+          { body: param[:body], page_id: param[:page_id],
+            revision_id: param[:revision_id], grant: param[:grant] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :post, url: entry_point,
+               payload: @param.to_json,
+               headers: { content_type: :json, accept: :json }
+             }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:page_id] && @param[:body]) 
+      return CPInvalidRequest.new 'Parameters page_id and body are required.'
+    end
+  end
+
+end
+
+# ページ閲覧済マークを付与リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+# @note 詳細不明
+class GApiRequestPagesSeen < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/pages.seen', METHOD_POST, { page_id: param[:page_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :post, url: entry_point,
+               payload: @param.to_json,
+               headers: { content_type: :json, accept: :json }
+             }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['seenUser']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:page_id]) 
+      return CPInvalidRequest.new 'Parameter page_id required.'
+    end
+  end
+
+end
+
+# ライクページ指定リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestLikesAdd < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/likes.add', METHOD_POST, { page_id: param[:page_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :post, url: entry_point,
+               payload: @param.to_json,
+               headers: { content_type: :json, accept: :json }
+             }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:page_id]) 
+      return CPInvalidRequest.new 'Parameter page_id required.'
+    end
+  end
+
+end
+
+# ライクページ指定解除リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestLikesRemove < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/likes.remove', METHOD_POST, { page_id: param[:page_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :post, url: entry_point,
+               payload: @param.to_json,
+               headers: { content_type: :json, accept: :json }
+             }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:page_id]) 
+      return CPInvalidRequest.new 'Parameter page_id required.'
+    end
+  end
+
+end
+
+# 更新ページ一覧リクエスト用クラス
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+# @note notification for 3rd party tool (like Slack)
+class GApiRequestPagesUpdatePost < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    super('/_api/pages.updatePost', METHOD_GET, { path: param[:path] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    params = { method: :get, url: entry_point, headers: { params: @param } }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute params
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    posts = []
+    ret['updatePost'].each do |post|
+      pages.push(GrowiPage.new(post))
+    end
+    return GApiReturn.new(ok: ret['ok'], data: posts)
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:path]) 
+      return CPInvalidRequest.new 'Parameter path required.'
+    end
+  end
+
+end
+
+# ページ削除リクエスト用クラス（API利用不可）
+# @ref https://github.com/growi/growi/blob/master/lib/routes/page.js
+class GApiRequestPagesRemove < GApiRequestBase
+
+  # コンストラクタ
+  # @override
+  # @param [Hash] param APIリクエストのパラメータ
+  def initialize(param = {})
+    raise Exception, 'API of pages.remove is forbidden'
+    super('/_api/pages.remove', METHOD_GET,
+          { page_id: param[:page_id], revision_id: param[:revision_id] })
+  end
+
+  # リクエストを実行する
+  # @override
+  # @param  [String] entry_point APIのエントリーポイントとなるURL（ex. http://localhost:3000/_api/pages.list）
+  # @param  [Hash] rest_client_param RestClientのパラメータ
+  # @return [Array] リクエスト実行結果
+  def execute(entry_point, rest_client_param: {})
+
+    if invalid?
+      return validation_msg
+    end
+    param = { method: :get, url: entry_point, headers: { params: @param } }.merge(rest_client_param)
+    ret = JSON.parse RestClient::Request.execute param
+    if (ret['ok'] == false)
+      return CPInvalidRequest.new "API return false with msg: #{ret['msg']}"
+    end
+    return GApiReturn.new(ok: ret['ok'], data: GrowiPage.new(ret['page']))
+  end
+
+protected
+
+  # バリデーションエラーを取得する
+  # @override
+  # @return [nil/CPInvalidRequest] バリデーションエラー結果
+  def _invalid
+    if ! (@param[:page_id] || @param[:revision_id]) 
+      return CPInvalidRequest.new 'Parameter page_id or revision_id is required.'
+    end
+  end
+
+end
+