Integração

SDKs para todas as linguagens

Configure sua API Key uma vez. O SDK captura automaticamente qualquer erro que derrube sua aplicação e envia para o dashboard.

🌐
Browser / Frontend
CDN · npm

Captura window.onerror e unhandledrejection automaticamente. Funciona em qualquer projeto JS, React, Vue ou Svelte.

Vanilla JS — via CDN (sem build)
<!-- Adicione no <head> do seu HTML -->
<script src="https://debugassist.com.br/sdk/browser.js"
        data-api-key="SUA_API_KEY"
        data-project="meu-app"></script>
npm (React, Vue, Svelte, etc.)
npm install debug-assist-browser
// Inicialização manual (ES module)
import DebugAssist from 'debug-assist-browser';
DebugAssist.init({ apiKey: 'SUA_API_KEY', projectName: 'meu-app' });
React — ErrorBoundary
import { ErrorBoundary } from 'debug-assist-browser/react';

// Envolva seu componente raiz:
<ErrorBoundary apiKey="SUA_API_KEY" projectName="meu-app"
               fallback={<p>Algo deu errado.</p>}>
  <App />
</ErrorBoundary>
Vue 3 — plugin
import DebugAssistPlugin from 'debug-assist-browser/vue';

app.use(DebugAssistPlugin, { apiKey: 'SUA_API_KEY', projectName: 'meu-app' });
Svelte
import { initDebugAssist } from 'debug-assist-browser/svelte';

// Em main.js ou componente raiz:
initDebugAssist({ apiKey: 'SUA_API_KEY', projectName: 'meu-app' });

Configuração

data-api-key / apiKeySua API Key (obrigatória)
data-project / projectNameNome do projeto (default: unknown)
data-base-url / baseUrlURL base da API (default: https://debugassist.com.br)
<meta name="debug-assist-enabled" content="0">Desliga o SDK em qualquer ambiente
🟢
Node.js
npm

Captura uncaughtException e unhandledRejection automaticamente.

Instalação
npm install debug-assist
Uso
const DebugAssist = require('debug-assist');

// Uma linha — captura todos os crashes automaticamente
DebugAssist.init({ apiKey: 'SUA_API_KEY', projectName: 'meu-projeto' });

Variáveis de ambiente

DEBUG_ASSIST_ENABLED=0Desliga o SDK (útil em CI/testes)
🐍
Python
pip

Registra sys.excepthook para capturar qualquer exceção não tratada. Python 3.8+, sem dependências.

Instalação
pip install debug-assist
Uso via variável de ambiente (recomendado)
# No terminal ou .env:
export DEBUG_ASSIST_API_KEY='SUA_API_KEY'

# No código — só importar já basta:
import debug_assist
Ou explicitamente
from debug_assist import DebugAssist
DebugAssist.init(api_key='SUA_API_KEY', project_name='meu-projeto')

Variáveis de ambiente

DEBUG_ASSIST_API_KEYSua API Key
DEBUG_ASSIST_PROJECTNome do projeto (default: unknown)
DEBUG_ASSIST_ENABLED=0Desliga o SDK
☕
Java
Maven

Registra Thread.setDefaultUncaughtExceptionHandler. Java 11+, sem dependências externas.

Maven (pom.xml)
<dependency>
  <groupId>io.github.debug-assist</groupId>
  <artifactId>debug-assist</artifactId>
  <version>1.0.0</version>
</dependency>
Uso
import io.github.debugassist.DebugAssist;

// Via env var DEBUG_ASSIST_API_KEY:
DebugAssist.init();

// Ou explicitamente:
DebugAssist.init("SUA_API_KEY", "meu-projeto");

Variáveis de ambiente

DEBUG_ASSIST_API_KEYSua API Key
DEBUG_ASSIST_PROJECTNome do projeto (default: unknown)
DEBUG_ASSIST_ENABLED=0Desliga o SDK
🐹
Go
go get

Captura panics via defer recover() e re-panic após enviar. Go 1.21+, sem dependências externas.

Instalação
go get github.com/debug-assist/sdk-go
Uso
import debugassist "github.com/debug-assist/sdk-go"

func main() {
    debugassist.Wrap(run) // uma linha
}

func run() {
    // seu código aqui
}

Variáveis de ambiente

DEBUG_ASSIST_API_KEYSua API Key
DEBUG_ASSIST_PROJECTNome do projeto (default: unknown)
DEBUG_ASSIST_ENABLED=0Desliga o SDK
🐘
PHP
require

Registra set_exception_handler e register_shutdown_function para capturar exceções e erros fatais. PHP 7.4+, sem Composer.

Instalação — copie o arquivo para seu projeto
# Ou via Composer (em breve):
composer require debug-assist/debug-assist
Uso
require_once 'debug_assist.php'; // só isso

Variáveis de ambiente ou constantes PHP

DEBUG_ASSIST_API_KEYSua API Key
DEBUG_ASSIST_PROJECTNome do projeto (default: unknown)
DEBUG_ASSIST_ENABLED=0Desliga o SDK
💎
Ruby
gem

Usa at_exit com $! para capturar exceções não tratadas. MRI Ruby 2.7+, sem gems externas.

Instalação
gem install debug-assist
Uso
require 'debug-assist' # só isso

Variáveis de ambiente

DEBUG_ASSIST_API_KEYSua API Key
DEBUG_ASSIST_PROJECTNome do projeto (default: unknown)
DEBUG_ASSIST_ENABLED=0Desliga o SDK
🔷
C#
NuGet

Registra AppDomain.UnhandledException e TaskScheduler.UnobservedTaskException. .NET 6+, sem pacotes externos.

Instalação
dotnet add package DebugAssist
Uso
using DebugAssistSDK;

// Uma linha no topo de Program.cs:
DebugAssist.EnsureInitialized();

// Ou explicitamente:
DebugAssist.Init("SUA_API_KEY", "meu-projeto");

Variáveis de ambiente

DEBUG_ASSIST_API_KEYSua API Key
DEBUG_ASSIST_PROJECTNome do projeto (default: unknown)
DEBUG_ASSIST_ENABLED=0Desliga o SDK