Documentação da API
Integre as ferramentas da Respawn Tech Dev com uma API REST previsível — autenticação por token, cobrança em créditos e dry-run em todas as operações pagas.
Ferramentas
QR Dinâmico
QR codes com destino editável, design customizável e analytics de scans.
PDF Convert
Conversão assíncrona de HTML/CSS em PDF, PNG ou JPG, unitária ou em batch.
Verificação de URL
Checagem de URLs maliciosas e proxy de favicon por domínio.
Base de conhecimento · Beta
Busca semântica e híbrida nos seus documentos, para RAG e assistentes.
Webhook Relay · Beta
Envie webhooks assinados para os seus clientes, com retry, log de tentativas e replay.
Realtime
Publique e receba mensagens em tempo real por WebSocket ou SSE, com presença, histórico e reconexão sem perder mensagens.
Extrator de erro de CI
Extrai de um log de CI só as linhas que explicam a falha.
Página web para Markdown
Baixa uma página web e devolve o conteúdo principal em Markdown, com opção de gravar na base de conhecimento.
Notificações
Um agente avisa o seu humano por e-mail, webhook ou ntfy.
Memória de aprendizados
Memória de longo prazo para agentes: salve o que aprendeu num projeto e recupere antes da próxima tarefa.
Áudio
Transcrição, voz sintética, sons gerados, análise e conversão de áudio, com jobs assíncronos.
Primeiros passos
Crie um token de API
No dashboard, abra APIs e crie um token com os escopos da ferramenta que vai usar. Guarde-o na variável de ambiente RESPAWN_API_TOKEN. Veja Autenticação.
Estime o custo com dry-run
Envie X-Dry-Run: true antes de uma operação paga para validar o payload e ver o custo sem debitar créditos. Veja Cobrança e limites.
Faça a chamada
Todas as rotas de ferramentas usam o prefixo https://api.respawntech.dev/v1/tools. Cada endpoint traz exemplos prontos em cURL, JavaScript e Python.
curl -sS -X GET 'https://api.respawntech.dev/v1/tools/image/qr-code/dynamic?limit=20' \
-H "X-API-Token: $RESPAWN_API_TOKEN"const response = await fetch('https://api.respawntech.dev/v1/tools/image/qr-code/dynamic?limit=20', {
method: 'GET',
headers: {
'X-API-Token': process.env.RESPAWN_API_TOKEN,
},
});
if (!response.ok) throw new Error((await response.json()).error.code);
console.log(await response.json());import os
import requests
response = requests.get(
"https://api.respawntech.dev/v1/tools/image/qr-code/dynamic?limit=20",
headers={
"X-API-Token": os.environ["RESPAWN_API_TOKEN"],
},
timeout=30,
)
if not response.ok:
raise RuntimeError(response.json()["error"]["code"])
print(response.json())<?php
$ch = curl_init('https://api.respawntech.dev/v1/tools/image/qr-code/dynamic?limit=20');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'X-API-Token: ' . getenv('RESPAWN_API_TOKEN'),
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status >= 400) {
throw new RuntimeException(json_decode($body, true)['error']['code']);
}
print_r(json_decode($body, true));package main
import (
"fmt"
"io"
"net/http"
"os"
"time"
)
func main() {
req, err := http.NewRequest("GET", "https://api.respawntech.dev/v1/tools/image/qr-code/dynamic?limit=20", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Token", os.Getenv("RESPAWN_API_TOKEN"))
client := &http.Client{Timeout: 30 * time.Second}
res, err := client.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
if res.StatusCode >= 400 {
panic(string(data))
}
fmt.Println(string(data))
}Headers comuns
| Header | Valor | Efeito |
|---|---|---|
X-API-Token | rsk_live_... | Autenticação (recomendado) |
X-Dry-Run | true | Simula a operação sem persistir nem debitar |
X-Include-Cost | true | Inclui meta.cost na resposta |
X-Idempotency-Key | UUID | Evita cobrança duplicada em reenvios (24 horas) |
Respostas trazem X-Trace-Id (use em tickets de suporte), X-RateLimit-* e, em leituras medidas, X-API-Quota-*.
Guias
Autenticação
Token de API, escopos e requisitos da conta.
Cobrança e limites
Créditos, dry-run, idempotência, rate limit e franquia diária.
Webhooks
Eventos da conta, assinatura Standard Webhooks, retries e callbacks de jobs.
Códigos de erro
Envelope de resposta e todos os códigos por ferramenta.
Agentes de IA (MCP)
Conecte Claude, Cursor e outros agentes às ferramentas, com limite de gasto.
Atualizado em