vatcheckapi 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7db61150097470eb862b0a2db35b82c277c357245eb5e6080c77bae329ae5fcb
+  data.tar.gz: dfc3eda34895bcbf7fc2b448142c3d9d8506ad97416e0e44f3be69e0fd1c4cad
+SHA512:
+  metadata.gz: 36568c89fbc57010ca70e052dca8f1cb19e2f761ed1b5adc25c90ac22a8a7d45e599eab8a9bfb01d67452abccf6ef470d8b0caa297893a145f8ecd156098bbe3
+  data.tar.gz: 1eb3b96e25679a61359b5b65c264c95eda5237c1f39aa9abe0d7f908e6db50d29c1102231a20239568758e313916a11432946b1bf685cd6132721083da2092e3

data/README.md

@@ -0,0 +1,32 @@
+### vatcheckapi-ruby
+Ruby client for the `vatcheckapi.com` API.
+
+Website: [vatcheckapi.com](https://vatcheckapi.com)
+
+### Installation
+
+```bash
+gem install vatcheckapi
+```
+
+### Usage
+
+```ruby
+require 'vatcheckapi'
+
+client = Vatcheckapi::Client.new(api_key: ENV['VATCHECK_API_KEY'])
+
+res = client.check(vat_number: 'DE123456789')
+puts res
+
+status = client.status
+puts status
+```
+
+Authentication can be provided via `apikey` header (default) or query parameter:
+
+```ruby
+client = Vatcheckapi::Client.new(api_key: 'KEY', auth_in_query: true)
+```
+
+

data/lib/vatcheckapi/client.rb

@@ -0,0 +1,61 @@
+require 'net/http'
+require 'uri'
+require 'json'
+
+module Vatcheckapi
+  class Client
+    DEFAULT_BASE_URL = 'https://api.vatcheckapi.com/v2'
+
+    def initialize(api_key:, base_url: DEFAULT_BASE_URL, auth_in_query: false, header_name: 'apikey', timeout: 10)
+      raise ArgumentError, 'api_key is required' if api_key.nil? || api_key.empty?
+      @api_key = api_key
+      @base_url = base_url.gsub(%r{/$}, '')
+      @auth_in_query = !!auth_in_query
+      @header_name = header_name
+      @timeout = timeout
+    end
+
+    def status
+      request('status')
+    end
+
+    def check(params = {})
+      request('check', params)
+    end
+
+    private
+
+    def request(path, params = {})
+      params = (params || {}).dup
+      if @auth_in_query
+        params['apikey'] ||= @api_key
+      end
+
+      uri = URI.parse("#{@base_url}/#{path}")
+      uri.query = URI.encode_www_form(params) unless params.empty?
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = (uri.scheme == 'https')
+      http.read_timeout = @timeout
+      http.open_timeout = @timeout
+
+      req = Net::HTTP::Get.new(uri.request_uri)
+      req['Accept'] = 'application/json'
+      req[@header_name] = @api_key unless @auth_in_query
+
+      res = http.request(req)
+      body = res.body.to_s
+      content_type = res['content-type'] || ''
+      data = content_type.include?('application/json') ? JSON.parse(body) rescue { 'raw' => body } : { 'raw' => body }
+
+      unless res.is_a?(Net::HTTPSuccess)
+        message = data.is_a?(Hash) ? (data['message'] || data['error']) : nil
+        raise StandardError, "vatcheckapi error: #{res.code} #{res.message}: #{message}"
+      end
+
+      data
+    end
+  end
+end
+
+

data/lib/vatcheckapi.rb

@@ -0,0 +1,7 @@
+require_relative "vatcheckapi/client"
+
+module Vatcheckapi
+  VERSION = "0.1.0"
+end
+
+

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: vatcheckapi
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ''
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Simple Ruby client for the VAT Check API with status and validate endpoints.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/vatcheckapi.rb
+- lib/vatcheckapi/client.rb
+homepage: https://vatcheckapi.com/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://vatcheckapi.com/
+  source_code_uri: https://github.com/everapihq/vatcheckapi-ruby
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Ruby client for vatcheckapi.com (status, validate)
+test_files: []