Conta Clara API · Documentação · Exemplos

Exemplos da API

URLs de produção: https://api.rohnelt.dev. Valores em reais; use ponto decimal. Sem chave: 50 chamadas/dia UTC por IP. Chave anual: R$ 197,00 por 365 dias, 20.000 chamadas/dia, sem renovação automática.

Python usa apenas a biblioteca padrão. JavaScript roda no Node.js 20+ (arquivo .mjs). Defina CONTA_CLARA_API_KEY no ambiente do servidor; não publique a chave em código de navegador, repositórios ou logs. Para testar sem chave, remova o cabeçalho X-API-Key.

curl — INSS grátis

curl --fail-with-body 'https://api.rohnelt.dev/v1/inss?salary=3000'

Python 3 — férias com chave anual

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://api.rohnelt.dev/v1/ferias',
    data=json.dumps({'salary': 3000, 'days': 30}).encode(),
    headers={'Content-Type': 'application/json',
             'X-API-Key': os.environ['CONTA_CLARA_API_KEY']},
    method='POST',
)
with urllib.request.urlopen(request, timeout=20) as response:
    print(json.load(response))

JavaScript — Node.js 20+, férias com chave anual

if (!process.env.CONTA_CLARA_API_KEY) throw new Error('Defina CONTA_CLARA_API_KEY');
const response = await fetch('https://api.rohnelt.dev/v1/ferias', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.CONTA_CLARA_API_KEY,
  },
  body: JSON.stringify({ salary: 3000, days: 30 }),
  signal: AbortSignal.timeout(20000),
});
if (!response.ok) throw new Error(response.status + ': ' + await response.text());
console.log(await response.json());

curl — ferramentas MCP sem chave

curl --fail-with-body https://api.rohnelt.dev/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"exemplo","version":"1.0.0"}}}'
curl --fail-with-body https://api.rohnelt.dev/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'
curl --fail-with-body https://api.rohnelt.dev/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"inss","arguments":{"salary":3000}}}'

O exemplo INSS retorna result.inss = 248.6. Respostas têm year, input, result e notice. 400: entrada inválida; 401: chave inválida ou expirada; 429: limite diário (consulte Retry-After). Chamadas MCP também consomem franquia; transporte HTTP sem sessão.

Parâmetros dos oito cálculos · OpenAPI