mfkessai-ruby 1.0.0.beta1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 67112c72373759e261b00b94f3c496e03b0ced828c2967ec19b6683e447f2566
+  data.tar.gz: 3dbdb547117293ac159653907289bb7480d8c2c40689c0b5f05c53d2f42e9c4c
+SHA512:
+  metadata.gz: 537cb562321a03bccfabfe962643a270307dab56913dc64e4ff2020c28fb2879f24c3c19e7f6e3d88fe103c60c1780b6b26f4b4147ac151d6f187f7cd12cf4df
+  data.tar.gz: 8eff324befa18b38a9287798d0a3d32e3fbe2f450dd82c395a326324db3a0ab7b95ecd84f536cf0eb4c1d9ecab7f7d9fae6b7e46bff0d3491eca1873cdd78f72

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.gitlab-ci.yml

@@ -0,0 +1,65 @@
+stages:
+  - test
+
+ruby2.3:rspec:
+  image: ruby:2.3-alpine
+
+  script:
+    - setup
+    - execute_rspec
+
+ruby2.4:rspec:
+  image: ruby:2.4-alpine
+
+  script:
+    - setup
+    - execute_rspec
+
+ruby2.5:rspec:
+  image: ruby:2.5-alpine
+
+  script:
+    - setup
+    - execute_rspec
+
+ruby2.5.1:rspec:
+  image: ruby:2.5.1-alpine
+
+  script:
+    - setup
+    - execute_rspec
+
+  allow_failure: true
+
+dependency_scanning:
+  image: docker:stable
+  variables:
+    DOCKER_DRIVER: overlay2
+  allow_failure: true
+  services:
+    - docker:stable-dind
+  script:
+    - export SP_VERSION=$(echo "$CI_SERVER_VERSION" | sed 's/^\([0-9]*\)\.\([0-9]*\).*/\1-\2-stable/')
+    - docker run
+        --env DEP_SCAN_DISABLE_REMOTE_CHECKS="${DEP_SCAN_DISABLE_REMOTE_CHECKS:-false}"
+        --volume "$PWD:/code"
+        --volume /var/run/docker.sock:/var/run/docker.sock
+        "registry.gitlab.com/gitlab-org/security-products/dependency-scanning:$SP_VERSION" /code
+  artifacts:
+    paths: [gl-dependency-scanning-report.json]
+
+.auto_devops: &auto_devops |
+  function execute_rspec() {
+    bundle exec rspec
+  }
+
+  function setup() {
+    apk --update --upgrade add $BUILD_PACKAGES
+    apk add git
+    gem install bundler --no-ri --no-rdoc
+    bundle check --path=${BUNDLE_CACHE} || bundle install --path=${BUNDLE_CACHE} --jobs=2 --retry=3
+    bundle clean
+  }
+
+before_script:
+  - *auto_devops

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in mfkessai-ruby.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,39 @@
+PATH
+  remote: .
+  specs:
+    mfkessai-ruby (1.0.0.beta1)
+      faraday (~> 0.10)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.3)
+    faraday (0.15.2)
+      multipart-post (>= 1.2, < 3)
+    multipart-post (2.0.0)
+    rake (10.5.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  mfkessai-ruby!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   1.16.2

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2018 TORU FUKUI (https://gitlab.com/torufukui)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,340 @@
+### **！こちらのgemはまだbeta版です**
+
+# Mfkessai for Ruby
+mfkessaiのapiを使用するための便利なアクセスをRubyで提供します
+
+こちらのgemは非公式なライブラリです
+
+対応API
+
+- customer
+- destination
+- examination
+- ping
+- transaction
+
+[詳しいAPIを参照する](https://mfkessai.co.jp/api_doc/endpoint.html)
+
+## Installation
+
+```
+$ gem install mfkessai-ruby -v 1.0.0.beta1 --pre
+```
+
+## Usage
+
+ライブラリは、利用可能なアカウントの秘密鍵と本番環境かテスト環境かのURLの設定をする必要があります。
+
+Mfkessai.api_key, Mfkessai.api_urlをその値に設定します。
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# list customers
+Mfkessai::Customer.list
+
+# retrieve single customer
+Mfkessai::Customer.retrieve("customer_test_123")
+```
+
+## API一覧
+
+## customer
+
+- Mfkessai::Customer.list
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 顧客リストを取得
+Mfkessai::Customer.list
+```
+
+- Mfkessai::Customer.retrieve
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 顧客IDを指定して取得
+Mfkessai::Customer.retrieve("customer_test_123")
+```
+
+## destination
+
+- Mfkessai::Destination.create
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 請求先を登録
+params = {
+  "address1": "世田谷区1-2-3",
+  "address2": "ビル3F",
+  "cc_emails": [
+    "another.test1@example.jp",
+    "another.test2@example.jp"
+  ],
+  "customer": {
+    "office_name": "テスト商事株式会社",
+    "user_defined_id": "customer123456"
+  },
+  "customer_id": "ABCD-EFGH",
+  "department": "経理部",
+  "email": "test@example.jp",
+  "name": "請求先氏名",
+  "prefecture": "東京都",
+  "tel": "03-1234-5678",
+  "title": "",
+  "zip_code": "111-1111"
+}
+Mfkessai::Destination.create(request_body: params)
+```
+
+## examination
+- Mfkessai::Destination.list
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 審査リストを取得
+Mfkessai::Destination.list
+```
+
+- Mfkessai::Destination.create
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 審査のための取引情報を登録
+params = {
+  "amount": 2160,
+  "destination_id": "XXXX-YYYY",
+  "due_date": "2018-05-31T00:00:00+09:00",
+  "examination_details": [
+    {
+      "amount": 2000,
+      "description": "商品名A",
+      "quantity": 2,
+      "unit_price": 1000
+    },
+    {
+      "amount": 160,
+      "description": "消費税",
+      "quantity": 1,
+      "unit_price": 160
+    }
+  ]
+}
+
+Mfkessai::Destination.create(request_body: params)
+```
+
+- Mfkessai::Destination.retrieve
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# IDを指定して審査情報を取得
+Mfkessai::Destination.retrieve('destination_test_123')
+```
+
+- Mfkessai::Destination.create_transaction
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 審査時に登録した情報をもとに取引を登録
+
+params = {
+  "date": "2018-04-16T00:00:00+09:00",
+  "email_flag": true,
+  "issue_date": "2018-05-16T00:00:00+09:00",
+  "posting_flag": false,
+  "user_defined_id": "transaction00000001"
+}
+
+Mfkessai::Destination.create_transaction(id: 'test_123', request_body: params)
+```
+
+## ping
+
+- Mfkessai::Ping.send
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# pingを飛ばす
+Mfkessai::Ping.send
+```
+
+## transaction
+
+- Mfkessai::Transaction.list
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 取引リストを取得
+
+Mfkessai::Transaction.list
+```
+
+- Mfkessai::Transaction.create
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 取引を登録
+params = {
+  "amount": 2160,
+  "date": "2018-04-16T00:00:00+09:00",
+  "destination": {
+    "address1": "千代田区1-2-3",
+    "address2": "サンプルビル3F",
+    "cc_emails": [
+      "another.test1@example.jp",
+      "another.test2@example.jp"
+    ],
+    "customer": {
+      "office_name": "サンプル商事株式会社",
+      "user_defined_id": "customer123456"
+    },
+    "customer_id": "ABCD-EFGH",
+    "department": "経理部",
+    "email": "kesai.tanto@example.jp",
+    "name": "請求先氏名",
+    "prefecture": "東京都",
+    "tel": "03-1234-5678",
+    "title": "",
+    "zip_code": "111-1111"
+  },
+  "destination_id": "XXXX-YYYY",
+  "due_date": "2018-05-31T00:00:00+09:00",
+  "email_flag": true,
+  "issue_date": "2018-05-16T00:00:00+09:00",
+  "posting_flag": false,
+  "transaction_details": [
+    {
+      "amount": 2000,
+      "description": "商品名A",
+      "quantity": 2,
+      "unit_price": 1000
+    },
+    {
+      "amount": 160,
+      "description": "消費税",
+      "quantity": 1,
+      "unit_price": 160
+    }
+  ],
+  "user_defined_id": "transaction00000001"
+}
+
+Mfkessai::Transaction.create(request_body: params)
+```
+
+- Mfkessai::Transaction.retrieve
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 取引IDを指定して取得
+Mfkessai::Transaction.retrieve("transation_test_123")
+```
+
+- Mfkessai::Transaction.cancel
+
+```
+require "mfkessai"
+Mfkessai.api_url = "https://sandbox"
+Mfkessai.api_key = "mfkessai_test_..."
+
+# 取引をキャンセル
+
+Mfkessai::Transaction.cancel("transation_test_123")
+```
+
+## Handling errors
+
+```
+begin
+  # Use Mfkessai's library to make requests...
+rescue Mfkessai::BadRequestError => e
+  puts "Status is: #{e.http_status}"
+  puts "Message is: #{e.message}"
+  puts "http_body is: #{e.http_body}"
+  puts "json_body is: #{e.json_body}"
+rescue Mfkessai::AuthenticationError => e
+  puts "Status is: #{e.http_status}"
+  puts "Message is: #{e.message}"
+  puts "http_body is: #{e.http_body}"
+  puts "json_body is: #{e.json_body}"
+rescue Mfkessai::ForbiddenError => e
+  puts "Status is: #{e.http_status}"
+  puts "Message is: #{e.message}"
+  puts "http_body is: #{e.http_body}"
+  puts "json_body is: #{e.json_body}"
+rescue Mfkessai::NotFoundError => e
+  puts "Status is: #{e.http_status}"
+  puts "Message is: #{e.message}"
+  puts "http_body is: #{e.http_body}"
+  puts "json_body is: #{e.json_body}"
+rescue Mfkessai::APIConnectionError => e
+  puts "Status is: #{e.http_status}"
+  puts "Message is: #{e.message}"
+  puts "http_body is: #{e.http_body}"
+  puts "json_body is: #{e.json_body}"
+rescue Mfkessai::ServerError => e
+  puts "Status is: #{e.http_status}"
+  puts "Message is: #{e.message}"
+  puts "http_body is: #{e.http_body}"
+  puts "json_body is: #{e.json_body}"
+rescue => e
+   # Something else happened, completely unrelated to Mfkessai
+end
+
+```
+
+## Development
+
+Run all tests:
+
+```
+bundle exec rspec spec
+```
+
+## Contributing
+
+1. Fork it
+1. Create your feature branch (git checkout -b my-new-feature)
+1. Commit your changes (git commit -am 'Add some feature')
+1. Push to the branch (git push origin my-new-feature)
+1. Create new Pull Request
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "mfkessai/ruby"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/gitlab-ci/rspec.sh

@@ -0,0 +1,3 @@
+#!/bin/bash -xe
+
+bundle exec rspec

data/gitlab-ci/setup.sh

@@ -0,0 +1,6 @@
+#!/bin/bash -xe
+
+apk --update --upgrade add $BUILD_PACKAGES
+gem install bundler --no-ri --no-rdoc
+bundle check --path=${BUNDLE_CACHE} || bundle install --path=${BUNDLE_CACHE} --jobs=2 --retry=3
+bundle clean

data/lib/mfkessai/client.rb

@@ -0,0 +1,207 @@
+# frozen_string_literal: true
+module Mfkessai
+  module Client
+    def request(url:, request_type:, request_body: nil)
+      api_url = Mfkessai.api_url
+      api_key = Mfkessai.api_key
+
+      check_api_key!(api_key)
+
+      url = "#{api_url}#{url}"
+      uri = URI.parse(url)
+
+      conn = Faraday.new(:ssl => {:verify => false}) do |c|
+        c.use Faraday::Request::Multipart
+        c.use Faraday::Request::UrlEncoded
+        c.use Faraday::Response::RaiseError
+        c.adapter Faraday.default_adapter
+      end
+
+      payload = request_body.nil? ? request_body : request_body.to_json
+
+      http_resp = conn.run_request(request_type, uri, payload, request_headers) do |req|
+        req.options.open_timeout = Mfkessai.open_timeout
+        req.options.timeout = Mfkessai.read_timeout
+      end
+      from_faraday_response(http_resp)
+    rescue JSON::ParserError => e
+      raise general_api_error(status: http_resp.status, body: http_resp.body)
+    rescue Faraday::ClientError => e
+      if e.response
+        handle_error_response(error_response: e.response)
+      else
+        handle_network_error(e)
+      end
+    rescue AuthenticationError => e
+      raise AuthenticationError.new(http_status: 401, message: e.message)
+    rescue StandardError => e
+      raise ServerError.new(http_status: 500)
+    end
+
+    def from_faraday_response(http_resp)
+      response = Struct.new(:data, :http_body, :http_headers, :http_status)
+      resp = response.new
+
+      # response bodyがokの場合、v1/pingからのリクエストなので処理を分ける
+      if http_resp.body == 'ok'
+        resp.http_body = http_resp.body
+        resp.http_headers = http_resp.headers
+        resp.http_status = http_resp.status
+      else
+        resp.data = JSON.parse(http_resp.body, symbolize_names: true)
+        resp.http_body = http_resp.body
+        resp.http_headers = http_resp.headers
+        resp.http_status = http_resp.status
+      end
+      resp
+    end
+
+    def request_headers
+      headers = {
+        "User-Agent" => "Mfkessai/v1 RubyBindings/#{Mfkessai::VERSION}",
+        "apiKey" => Mfkessai.api_key,
+        "Content-Type" => "application/json",
+      }
+
+      headers["Mfkessai-Version"] = Mfkessai.api_version if Mfkessai.api_version
+
+      begin
+        headers.update(
+          "X-Mfkessai-Client-User-Agent" => JSON.generate(user_agent)
+        )
+      rescue StandardError => e
+        headers.update(
+          "X-Mfkessai-Client-Raw-User-Agent" => user_agent.inspect,
+          :error => "#{e} (#{e.class})"
+        )
+      end
+      headers
+    end
+
+    def user_agent
+      @uname ||= uname
+      lang_version = "#{RUBY_VERSION} p#{RUBY_PATCHLEVEL} (#{RUBY_RELEASE_DATE})"
+
+      {
+        :bindings_version => Mfkessai::VERSION,
+        :lang => 'ruby',
+        :lang_version => lang_version,
+        :platform => RUBY_PLATFORM,
+        :engine => defined?(RUBY_ENGINE) ? RUBY_ENGINE : '',
+        :uname => @uname,
+        :hostname => Socket.gethostname
+      }
+    end
+
+    def uname
+      if File.exist?('/proc/version')
+        File.read('/proc/version').strip
+      else
+        case RbConfig::CONFIG['host_os']
+        when /linux|darwin|bsd|sunos|solaris|cygwin/i
+          _uname_uname
+        when /mswin|mingw/i
+          _uname_ver
+        else
+          "unknown platform"
+        end
+      end
+    end
+
+    def _uname_uname
+      (`uname -a 2>/dev/null` || '').strip
+    rescue Errno::ENOMEM # couldn't create subprocess
+      "uname lookup failed"
+    end
+
+    def _uname_ver
+      (`ver` || '').strip
+    rescue Errno::ENOMEM # couldn't create subprocess
+      "uname lookup failed"
+    end
+
+    def handle_error_response(error_response:)
+      case error_response[:status]
+      when 400
+        data = JSON.parse(error_response[:body], symbolize_names: true)
+        raise BadRequestError.new(message: data[:detail],
+                                  http_status: error_response[:status],
+                                  http_body: error_response[:body],
+                                  json_body: data)
+      when 401
+        data = JSON.parse(error_response[:body], symbolize_names: true)
+        raise AuthenticationError.new(message: data[:detail],
+                                      http_status: error_response[:status],
+                                      http_body: error_response[:body],
+                                      json_body: data)
+      when 403
+        data = JSON.parse(error_response[:body], symbolize_names: true)
+        raise ForbiddenError.new(message: data[:detail],
+                                 http_status: error_response[:status],
+                                 http_body: error_response[:body],
+                                 json_body: data)
+      when 404
+        data = JSON.parse(error_response[:body], symbolize_names: true)
+        raise NotFoundError.new(message: data[:detail],
+                                http_status: error_response[:status],
+                                http_body: error_response[:body],
+                                json_body: data)
+      when 500
+        data = JSON.parse(error_response[:body], symbolize_names: true)
+        raise ServerError.new(message: data[:detail],
+                              http_status: error_response[:status],
+                              http_body: error_response[:body],
+                              json_body: data)
+      when 503
+        data = JSON.parse(error_response[:body], symbolize_names: true)
+        raise ServerError.new(message: data[:detail],
+                              http_status: error_response[:status],
+                              http_body: error_response[:body],
+                              json_body: data)
+      else
+        raise ServerError.new(http_status: 500)
+      end
+    end
+
+    def handle_network_error(e)
+      case e
+      when Faraday::ConnectionFailed
+        message = "Unexpected error communicating when trying to connect to Mfkessai. " \
+          "You may be seeing this message because your DNS is not working. "
+      when Faraday::SSLError
+        message = "Could not establish a secure connection to Mfkessai, you may " \
+                  "need to upgrade your OpenSSL version. To check, try running "
+      when Faraday::TimeoutError
+        message = "Could not connect to Mfkessai (#{Mfkessai.api_key}). " \
+          "Please check your internet connection and try again. "
+      else
+        message = "Unexpected error communicating with Mfkessai. "
+      end
+
+      message += " Request was retried"
+
+      raise APIConnectionError.new(message: message + "\n\n(Network error: #{e.message})")
+    end
+
+    def general_api_error(status:, body:)
+      error_message = "Invalid response object from API: #{body.inspect} \n HTTP response code was #{status})"
+      APIConnectionError.new(message: error_message,
+                             http_status: status,
+                             http_body: body)
+    end
+
+    def check_api_key!(api_key)
+      unless api_key
+        error_message = "No API key provided. " \
+          'Set your API key using "Mfkessai.api_key = <API-KEY>". ' \
+          "You can generate API keys from the Mfkessai web interface. "
+        raise AuthenticationError.new(message: error_message)
+      end
+
+      return unless api_key =~ /\s/
+      error_message = "Your API key is invalid, as it contains " \
+        "whitespace. (HINT: You can double-check your API key from the "
+      raise AuthenticationError.new(message: error_message)
+    end
+  end
+end

data/lib/mfkessai/customer.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+module Mfkessai
+  class Customer
+    extend Mfkessai::Client
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/customer/customer_index
+    def self.list
+      request(url: '/v1/customers',
+              request_type: :get)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/customer/customer_show
+    def self.retrieve(id)
+      request(url: "/v1/customers/#{id}",
+              request_type: :get)
+    end
+  end
+end

data/lib/mfkessai/destination.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+module Mfkessai
+  class Destination
+    extend Mfkessai::Client
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/destination/destination_create
+    def self.create(request_body:)
+      request(url: '/v1/destinations',
+              request_type: :post,
+              request_body: request_body)
+    end
+  end
+end

data/lib/mfkessai/errors.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+module Mfkessai
+  class MfkessaiError < StandardError
+    attr_reader :message
+    attr_reader :http_status
+    attr_reader :http_body
+    attr_reader :json_body
+
+    def initialize(message: nil, http_status: nil, http_body: nil, json_body: nil)
+      @message = message
+      @http_status = http_status
+      @http_body = http_body
+      @json_body = json_body
+    end
+
+    def to_s
+      status_string = @http_status.nil? ? "" : "(Status #{@http_status}) "
+      "#{status_string}#{@message}"
+    end
+  end
+
+  # 400 Bad Request
+  class BadRequestError < MfkessaiError
+  end
+
+  # 401 Unauthorized
+  class AuthenticationError < MfkessaiError
+  end
+
+  # 403 Forbidden
+  class ForbiddenError < MfkessaiError
+  end
+
+  # 404 NotFound
+  class NotFoundError < MfkessaiError
+  end
+
+  # 500, 503 Internal Server Error
+  class ServerError < MfkessaiError
+  end
+
+  # APIConnectionError is raised in the event that the SDK can't connect to
+  # Mfkessai's servers.
+  class APIConnectionError < MfkessaiError
+  end
+end

data/lib/mfkessai/examination.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+module Mfkessai
+  class Examination
+    extend Mfkessai::Client
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/examination/examination_index
+    def self.list
+      request(url: '/v1/examinations',
+              request_type: :get)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/examination/examination_create
+    def self.create(request_body:)
+      request(url: '/v1/examinations',
+              request_type: :post,
+              request_body: request_body)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/examination/examination_show
+    def self.retrieve(id)
+      request(url: "/v1/examinations/#{id}",
+              request_type: :get)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/examination/examination_create_transaction
+    def self.create_transaction(id:, request_body:)
+      request(url: "/v1/examinations/#{id}/transaction",
+              request_type: :post,
+              request_body: request_body)
+    end
+  end
+end

data/lib/mfkessai/ping.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+module Mfkessai
+  class Ping
+    extend Mfkessai::Client
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/ping/ping_show
+    def self.send
+      request(url: '/v1/ping', request_type: :get)
+    end
+  end
+end

data/lib/mfkessai/transaction.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+module Mfkessai
+  class Transaction
+    extend Mfkessai::Client
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/transaction/transaction_index
+    def self.list
+      request(url: '/v1/transactions',
+              request_type: :get)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/transaction/transaction_create
+    def self.create(request_body:)
+      request(url: '/v1/transactions',
+              request_type: :post,
+              request_body: request_body)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/transaction/transaction_show
+    def self.retrieve(id)
+      request(url: "/v1/transactions/#{id}",
+              request_type: :get)
+    end
+
+    # ref: https://mfkessai.co.jp/api_doc/endpoint.html#/transaction/transaction_cancel
+    def self.cancel(id)
+      request(url: "/v1/transactions/#{id}/cancel",
+              request_type: :post)
+    end
+  end
+end

data/lib/mfkessai/version.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+module Mfkessai
+  VERSION = "1.0.0.beta1"
+end

data/lib/mfkessai.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+require 'net/http'
+require 'openssl'
+require 'json'
+require 'faraday'
+
+require 'mfkessai/version'
+require 'mfkessai/client'
+require 'mfkessai/customer'
+require 'mfkessai/destination'
+require 'mfkessai/examination'
+require 'mfkessai/ping'
+require 'mfkessai/transaction'
+require 'mfkessai/errors'
+
+module Mfkessai
+  @api_version = 'v1'
+  @open_timeout = 30
+  @read_timeout = 80
+
+  class << self
+    attr_accessor :api_key, :api_url, :api_version,
+                  :open_timeout, :read_timeout
+  end
+
+end

data/mfkessai-ruby.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "mfkessai/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "mfkessai-ruby"
+  spec.version       = Mfkessai::VERSION
+  spec.authors       = ["torufukui"]
+  spec.email         = ["fukui.development@gmail.com"]
+
+  spec.summary = 'Ruby bindings for the Mfkessai API'
+  spec.description = 'Ruby bindings for the Mfkessai API'
+  spec.homepage = "https://gitlab.com/torufukui/mfkessai-ruby"
+  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"] = "TODO: Set to 'http://mygemserver.com'"
+  # 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_dependency("faraday", "~> 0.10")
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: mfkessai-ruby
+version: !ruby/object:Gem::Version
+  version: 1.0.0.beta1
+platform: ruby
+authors:
+- torufukui
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ruby bindings for the Mfkessai API
+email:
+- fukui.development@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".gitlab-ci.yml"
+- ".rspec"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- gitlab-ci/rspec.sh
+- gitlab-ci/setup.sh
+- lib/mfkessai.rb
+- lib/mfkessai/client.rb
+- lib/mfkessai/customer.rb
+- lib/mfkessai/destination.rb
+- lib/mfkessai/errors.rb
+- lib/mfkessai/examination.rb
+- lib/mfkessai/ping.rb
+- lib/mfkessai/transaction.rb
+- lib/mfkessai/version.rb
+- mfkessai-ruby.gemspec
+homepage: https://gitlab.com/torufukui/mfkessai-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Ruby bindings for the Mfkessai API
+test_files: []