apigratis-sdk-ruby 0.0.1

data/lib/api_brasil/services/platform/reports_service.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require_relative "../base_service"
+
+module ApiBrasil
+  module Services
+    module Platform
+      # Relatorios e dashboard de consumo (`/reports/*`, `/dashboard/stats`).
+      class ReportsService < BaseService
+        # Estatisticas do dashboard: `GET /dashboard/stats`.
+        #
+        # @return [Object]
+        def dashboard_stats(options = {})
+          get("/dashboard/stats", options)
+        end
+
+        # Consumo: `GET /reports/consumption`.
+        #
+        # @return [Object]
+        def consumption(options = {})
+          get("/reports/consumption", options)
+        end
+
+        # Gera relatorio de consumo: `POST /reports/generate-consumption-report`.
+        #
+        # @return [Object]
+        def generate_consumption_report(body = nil, options = {})
+          post("/reports/generate-consumption-report", body, options)
+        end
+
+        # Extrato: `GET /reports/extract`.
+        #
+        # @return [Object]
+        def extract(options = {})
+          get("/reports/extract", options)
+        end
+
+        # Dashboard de relatorios: `GET /reports/dashboard`.
+        #
+        # @return [Object]
+        def dashboard(options = {})
+          get("/reports/dashboard", options)
+        end
+
+        # Resumo: `GET /reports/summary`.
+        #
+        # @return [Object]
+        def summary(options = {})
+          get("/reports/summary", options)
+        end
+
+        # Uso diario: `GET /reports/daily-usage`.
+        #
+        # @return [Object]
+        def daily_usage(options = {})
+          get("/reports/daily-usage", options)
+        end
+
+        # Resumo mensal: `GET /reports/monthly-summary`.
+        #
+        # @return [Object]
+        def monthly_summary(options = {})
+          get("/reports/monthly-summary", options)
+        end
+
+        # Analise de erros: `GET /reports/error-analysis`.
+        #
+        # @return [Object]
+        def error_analysis(options = {})
+          get("/reports/error-analysis", options)
+        end
+
+        # Analise por device: `GET /reports/device-analysis`.
+        #
+        # @return [Object]
+        def device_analysis(options = {})
+          get("/reports/device-analysis", options)
+        end
+
+        # Requisicoes recentes: `GET /reports/recent-requests`.
+        #
+        # @return [Object]
+        def recent_requests(options = {})
+          get("/reports/recent-requests", options)
+        end
+
+        # Estatisticas rapidas: `GET /reports/quick-stats`.
+        #
+        # @return [Object]
+        def quick_stats(options = {})
+          get("/reports/quick-stats", options)
+        end
+      end
+    end
+  end
+end

data/lib/api_brasil/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ApiBrasil
+  # Versao da SDK, usada tambem no header User-Agent.
+  VERSION = "0.0.1"
+end

data/lib/api_brasil.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative "api_brasil/version"
+require_relative "api_brasil/core/env"
+require_relative "api_brasil/core/errors"
+require_relative "api_brasil/core/retry"
+require_relative "api_brasil/core/transport"
+require_relative "api_brasil/core/http_client"
+require_relative "api_brasil/generated/catalog"
+require_relative "api_brasil/client"
+require_relative "api_brasil/legacy/service"
+
+# SDK oficial Ruby da plataforma APIBrasil - WhatsApp, SMS, consultas de
+# CPF/CNPJ, veiculos, CEP, correios, pagamentos PIX/boleto e mais.
+#
+#   require "api_brasil"
+#
+#   api = ApiBrasil.new(
+#     bearer_token: ENV["APIBRASIL_BEARER_TOKEN"],
+#     device_token: ENV["APIBRASIL_DEVICE_TOKEN"]
+#   )
+#
+#   api.whatsapp.send_text("number" => "5511999999999", "text" => "Ola!")
+#
+# Documentacao completa: https://doc.apibrasil.io
+module ApiBrasil
+  # Tipos do core reexportados para que o uso do dia a dia precise de um
+  # unico require.
+  HttpClient = Core::HttpClient
+  Env = Core::Env
+  Retry = Core::Retry
+  Transport = Core::Transport
+  TransportRequest = Core::Transport::Request
+  TransportResponse = Core::Transport::Response
+  NetHttpTransport = Core::Transport::NetHttpTransport
+  FaradayTransport = Core::Transport::FaradayTransport
+  Catalog = Generated::Catalog
+
+  # Hierarquia de erros.
+  ApiBrasilError = Core::Errors::ApiBrasilError
+  ValidationError = Core::Errors::ValidationError
+  AuthenticationError = Core::Errors::AuthenticationError
+  InsufficientBalanceError = Core::Errors::InsufficientBalanceError
+  PermissionError = Core::Errors::PermissionError
+  NotFoundError = Core::Errors::NotFoundError
+  RateLimitError = Core::Errors::RateLimitError
+  ServerError = Core::Errors::ServerError
+  NetworkError = Core::Errors::NetworkError
+  TimeoutError = Core::Errors::TimeoutError
+  ErrorFactory = Core::Errors::ErrorFactory
+
+  class << self
+    # Cria um cliente da plataforma.
+    #
+    #   ApiBrasil.new(bearer_token: "...", device_token: "...")
+    #
+    # @param config [Hash] veja `ApiBrasil::Core::HttpClient`
+    # @return [ApiBrasil::Client]
+    def new(config = {})
+      Client.new(config)
+    end
+
+    # Faz login e devolve `{ client:, session: }` com o cliente ja autenticado.
+    #
+    # @param credentials [Hash] `email` e `password`
+    # @param config [Hash]
+    # @return [Hash]
+    def login(credentials, config = {})
+      Client.login(credentials, config)
+    end
+  end
+end

data/lib/apigratis-sdk-ruby.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+# Atalho para quem prefere `require "apigratis-sdk-ruby"` (nome do gem).
+# A biblioteca vive em `ApiBrasil` - veja `lib/api_brasil.rb`.
+require_relative "api_brasil"

data/lib/apigratis.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "api_brasil"
+
+# Namespace legado (`Apigratis::Service`), mantido por compatibilidade com o
+# contrato antigo das SDKs APIGratis.
+#
+# @deprecated Prefira `ApiBrasil.new(...)`.
+module Apigratis
+  Service = ApiBrasil::Legacy::Service
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: apigratis-sdk-ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jhon
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.60'
+description: SDK oficial Ruby da plataforma APIBrasil - WhatsApp, SMS, consultas CPF/CNPJ,
+  veiculos, CEP, correios, pagamentos PIX/boleto e mais.
+email:
+- contato@apibrasil.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- SECURITY.md
+- lib/api_brasil.rb
+- lib/api_brasil/client.rb
+- lib/api_brasil/core/env.rb
+- lib/api_brasil/core/errors.rb
+- lib/api_brasil/core/http_client.rb
+- lib/api_brasil/core/retry.rb
+- lib/api_brasil/core/transport.rb
+- lib/api_brasil/core/transport/faraday_transport.rb
+- lib/api_brasil/core/transport/net_http_transport.rb
+- lib/api_brasil/generated/catalog.rb
+- lib/api_brasil/legacy/service.rb
+- lib/api_brasil/services/base_service.rb
+- lib/api_brasil/services/data/bulk_service.rb
+- lib/api_brasil/services/data/cep_service.rb
+- lib/api_brasil/services/data/chip_virtual_service.rb
+- lib/api_brasil/services/data/consulta_service.rb
+- lib/api_brasil/services/data/correios_service.rb
+- lib/api_brasil/services/data/dados_service.rb
+- lib/api_brasil/services/data/database_ip_service.rb
+- lib/api_brasil/services/data/fipe_service.rb
+- lib/api_brasil/services/data/proxies.rb
+- lib/api_brasil/services/data/ura_service.rb
+- lib/api_brasil/services/data/vehicles_service.rb
+- lib/api_brasil/services/device_proxy_service.rb
+- lib/api_brasil/services/messaging/evolution_service.rb
+- lib/api_brasil/services/messaging/sms_service.rb
+- lib/api_brasil/services/messaging/whats_meow_service.rb
+- lib/api_brasil/services/messaging/whatsapp_service.rb
+- lib/api_brasil/services/platform/account_service.rb
+- lib/api_brasil/services/platform/auth_service.rb
+- lib/api_brasil/services/platform/bearer_rate_limit_service.rb
+- lib/api_brasil/services/platform/catalog_service.rb
+- lib/api_brasil/services/platform/devices_service.rb
+- lib/api_brasil/services/platform/ip_whitelist_service.rb
+- lib/api_brasil/services/platform/payments_service.rb
+- lib/api_brasil/services/platform/reports_service.rb
+- lib/api_brasil/version.rb
+- lib/apigratis-sdk-ruby.rb
+- lib/apigratis.rb
+homepage: https://apibrasil.com.br
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://apibrasil.com.br
+  source_code_uri: https://github.com/jhowbhz/apigratis-sdk-ruby
+  bug_tracker_uri: https://github.com/jhowbhz/apigratis-sdk-ruby/issues
+  documentation_uri: https://doc.apibrasil.io
+  changelog_uri: https://github.com/jhowbhz/apigratis-sdk-ruby/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: SDK oficial Ruby da plataforma APIBrasil
+test_files: []