Referência da API

Fontes, tribunais, turmas e relatores disponíveis

Sem `fonte`: lista todas as fontes e tribunais do índice. Com `fonte`: também as turmas e relatores dessa base (até 200 cada). Use para descobrir os códigos válidos de `fonte`.

curl "https://api.ragjur.ai/api/v1/filtros?fonte=stj_integras" \
  -H "x-api-key: rj_..."

{
  "fontes": [
    {
      "key": "tjsp_cjsg",
      "count": 18240112
    },
    {
      "key": "stj_integras",
      "count": 2103455
    }
  ],
  "tribunais": [
    {
      "key": "TJSP",
      "count": 21004003
    }
  ],
  "turmas": [],
  "relatores": []
}

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Busca textual (BM25) ou híbrida (BM25 + kNN e5 + rerank)

Busca em ~62M julgados. 50 resultados por página. Por padrão exclui decisões-stub (`word_count < 10`) e deduplica ementas quase idênticas. `modo=hibrido` funde BM25 com kNN sobre `embedding_e5` (RRF) e reordena o topo com cross-encoder; se o serviço de embeddings estiver indisponível, responde só BM25 com `embedding_fallback: "bm25"`. Correção ortográfica automática: `sugestao` traz a query corrigida quando aplicável.

curl "https://api.ragjur.ai/api/v1/busca?q=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA&relator=NANCY%20ANDRIGHI&classe=REsp&dataInicio=2023-01-01&dataFim=2025-12-31" \
  -H "x-api-key: rj_..."

{
  "total": 18432,
  "pagina": 1,
  "totalPaginas": 200,
  "resultados": [
    {
      "score": 42.17,
      "fonte": "stj_integras",
      "tribunal": "STJ",
      "numero_processo": "REsp 1.987.654/SP",
      "classe": "REsp",
      "relator": "NANCY ANDRIGHI",
      "orgao_julgador": "TERCEIRA TURMA",
      "data_julgamento": "2024-05-14",
      "ementa": "RECURSO ESPECIAL. RESPONSABILIDADE CIVIL. INSCRIÇÃO INDEVIDA EM CADASTRO DE INADIMPLENTES. DANO MORAL IN RE IPSA...",
      "highlight": {
        "ementa": [
          "INSCRIÇÃO INDEVIDA ... <em>dano</em> <em>moral</em> in re ipsa"
        ]
      }
    }
  ],
  "turmas": [
    {
      "key": "TERCEIRA TURMA",
      "count": 6120
    },
    {
      "key": "QUARTA TURMA",
      "count": 5874
    }
  ],
  "relatores": [
    {
      "key": "NANCY ANDRIGHI",
      "count": 1402
    }
  ]
}

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Decisões semanticamente similares (GET)

Atalho GET para `POST /similaridade` (mesmos parâmetros em query). `texto` mínimo 10 caracteres.

curl "https://api.ragjur.ai/api/v1/similaridade?texto=rescis%C3%A3o%20indireta%20por%20atraso%20reiterado%20de%20sal%C3%A1rios&fonte=stj_integras&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Decisões semanticamente similares (embeddings e5)

Gera o embedding do texto (multilingual-e5-large-instruct, 1024d) e compara por cosseno com candidatos BM25 da base. Latência típica 3–10 s. Sem o serviço de embeddings → 500.

curl -X POST "https://api.ragjur.ai/api/v1/similaridade" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"texto":"rescisão indireta por atraso reiterado de salários","fonte":"tst_jurisprudencia","limite":5}'

{
  "similares": [
    {
      "numero_processo": "RR-1000123-45.2021.5.02.0001",
      "relator": "MAURICIO GODINHO DELGADO",
      "orgao_julgador": "3ª Turma",
      "data_publicacao": "2024-03-08",
      "ementa": "RESCISÃO INDIRETA. ATRASO REITERADO NO PAGAMENTO DE SALÁRIOS...",
      "similaridade": 91.37,
      "classificacao": "favoravel"
    }
  ],
  "total_candidatos": 200,
  "modelo_embedding": "intfloat/multilingual-e5-large-instruct",
  "provedor_embedding": "e5"
}

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Clusters temáticos (k-means sobre embeddings)

Agrupa uma amostra de decisões do tema em sub-temas. Latência 10–60 s. Requer serviço de embeddings.

curl "https://api.ragjur.ai/api/v1/clusters?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Panorama do tema: taxa de provimento por turma, relator e ano

Classifica as decisões do tema em categorias de resultado (favorável/desfavorável/parcial…) e agrega por turma (top 10), relator (top 10) e ano. `merito=true` indica que a taxa considera só decisões de mérito classificadas.

curl "https://api.ragjur.ai/api/v1/panorama?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

{
  "fonte": "stj_integras",
  "tribunal": "",
  "turma": "",
  "busca": "dano moral negativação indevida",
  "merito": true,
  "categorias": [
    {
      "key": "provido",
      "label": "Provido",
      "cor": "#16a34a"
    },
    {
      "key": "desprovido",
      "label": "Desprovido",
      "cor": "#dc2626"
    }
  ],
  "labelFavoravel": "Provido",
  "total": 18432,
  "classificados": 11205,
  "favoravel": 6318,
  "desfavoravel": 4887,
  "taxa_geral": 56.4,
  "turmas": [
    {
      "turma": "TERCEIRA TURMA",
      "total": 6120,
      "classificados": 3900,
      "favoravel": 2340,
      "desfavoravel": 1560,
      "taxa_favoravel": 60
    }
  ],
  "relatores": [
    {
      "relator": "NANCY ANDRIGHI",
      "total": 1402,
      "classificados": 910,
      "favoravel": 601,
      "desfavoravel": 309,
      "taxa_favoravel": 66
    }
  ],
  "anos": [
    {
      "ano": "2024",
      "total": 2310,
      "classificados": 1500,
      "favoravel": 870,
      "desfavoravel": 630,
      "taxa": 58
    }
  ],
  "_meta": {
    "n": 11205,
    "confianca": "alta",
    "nota": "Amostra robusta"
  }
}

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Ranking de relatores no tema (top 30) com taxa favorável

curl "https://api.ragjur.ai/api/v1/relator?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Divergência entre turmas (teste qui-quadrado)

Compara a taxa favorável entre órgãos julgadores do tribunal e testa se a diferença é estatisticamente significativa (χ², p < 0,05).

curl "https://api.ragjur.ai/api/v1/divergencia?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ" \
  -H "x-api-key: rj_..."

{
  "fonte": "stj_integras",
  "busca": "dano moral negativação indevida",
  "merito": true,
  "labelFavoravel": "Provido",
  "categorias": [
    {
      "key": "provido",
      "label": "Provido",
      "cor": "#16a34a"
    }
  ],
  "turmas": [
    {
      "turma": "TERCEIRA TURMA",
      "total": 6120,
      "classificados": 3900,
      "favoravel": 2340,
      "desfavoravel": 1560,
      "taxa_favoravel": 60
    },
    {
      "turma": "QUARTA TURMA",
      "total": 5874,
      "classificados": 3700,
      "favoravel": 1961,
      "desfavoravel": 1739,
      "taxa_favoravel": 53
    }
  ],
  "teste_divergencia": {
    "metodo": "chi-quadrado",
    "chi2": 37.9,
    "graus_liberdade": 1,
    "p_value": 0.0001,
    "significativo": true,
    "interpretacao": "Há divergência estatisticamente significativa entre as turmas (p=0.0001)"
  }
}

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Evolução trimestral da taxa favorável (com média móvel de 4 trimestres)

curl "https://api.ragjur.ai/api/v1/evolucao?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (Classificação direcional não disponível para este tema) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Detecção de mudança de entendimento (CUSUM + Welch t-test)

curl "https://api.ragjur.ai/api/v1/mudanca?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Pontos de ruptura na série temporal (CUSUM ou bayesiano)

curl "https://api.ragjur.ai/api/v1/breakpoints?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Taxa favorável com intervalo de confiança de Wilson (95%)

curl "https://api.ragjur.ai/api/v1/previsao?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA&relator=NANCY%20ANDRIGHI" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Previsão ponderada por recência (decaimento exponencial + Wilson)

Cada decisão recebe peso 2^(-idade/meia-vida). A meia-vida depende da área (`area`) ou é inferida do tema.

curl "https://api.ragjur.ai/api/v1/previsao-temporal?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA&relator=NANCY%20ANDRIGHI" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Predição multi-fator do resultado (base + turma + relator + tendência)

Combina a taxa-base do tema com desvios da turma e do relator e a tendência recente; devolve probabilidade, intervalo e texto interpretativo.

curl "https://api.ragjur.ai/api/v1/predicao?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA&relator=NANCY%20ANDRIGHI" \
  -H "x-api-key: rj_..."

{
  "predicao": {
    "probabilidade": 61.2,
    "intervalo": {
      "lower": 58.9,
      "upper": 63.4
    },
    "confianca": "alta",
    "n_decisoes": 3900
  },
  "fatores": {
    "base": {
      "taxa": 56.4,
      "n": 11205,
      "contribuicao": "+0.0"
    },
    "turma": {
      "nome": "TERCEIRA TURMA",
      "taxa": 60,
      "n": 3900,
      "desvio": "+3.6",
      "contribuicao": "+2.9"
    },
    "tendencia": {
      "direcao": "alta",
      "variacao_recente": "+4.1",
      "contribuicao": "+1.9"
    }
  },
  "interpretacao": "Probabilidade de resultado favorável de 61% (IC 95%: 59–63%). A Terceira Turma é 3,6 pp mais favorável que a média do tribunal e a tendência recente é de alta."
}

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 404 (Nenhum resultado / recurso não encontrado) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno) · 502 (Erro no Elasticsearch ou no modelo de IA)

Termos que diferenciam decisões favoráveis das desfavoráveis (log-odds)

curl "https://api.ragjur.ai/api/v1/argumentos?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Termos estatisticamente significativos (significant_text) de turma/tema

Timeout de 12 s no Elasticsearch: em caso de timeout devolve 200 com `termos: []` e `error` explicativo.

curl "https://api.ragjur.ai/api/v1/dna?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno) · 502 (Erro no Elasticsearch ou no modelo de IA)

Índice de rigor por julgador (desvio da média do tribunal)

curl "https://api.ragjur.ai/api/v1/rigor?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA&relator=NANCY%20ANDRIGHI" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Radar ideológico do relator (eixos temáticos vs. média do tribunal)

curl "https://api.ragjur.ai/api/v1/radar?relator=NANCY%20ANDRIGHI&fonte=stj_integras&tribunal=STJ" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Taxa de reforma/manutenção em 2ª instância (e comparativo com 1ª)

Exige `fonte_2g` (ou `fonte`, ou `tribunal` ∈ TJSP, TRF4, TRF3, TRF2, TRF1, TJMG, TJRS, TJPR, TJBA, TJDFT…). `fonte_1g` é inferida quando existe base de 1º grau relacionada; a leitura de alinhamento usa sobreposição de ICs de Wilson 95%.

curl "https://api.ragjur.ai/api/v1/taxa-reforma?fonte_2g=tjsp_cjsg&tribunal=STJ&busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&turma=TERCEIRA%20TURMA" \
  -H "x-api-key: rj_..."

Erros: 400 (`fonte_2g` ausente ou de 1ª instância) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Tempo entre julgamento e publicação: média, mediana, percentis, por turma e ano

curl "https://api.ragjur.ai/api/v1/tempo-tramitacao?busca=dano%20moral%20negativa%C3%A7%C3%A3o%20indevida&fonte=stj_integras&tribunal=STJ&turma=TERCEIRA%20TURMA&relator=NANCY%20ANDRIGHI" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Análise estratégica completa de um julgador para um tema

Executa em paralelo perfil, DNA, argumentos, evolução e rigor (12 s cada) e devolve também um `prompt_estrategia` pronto para um LLM. Latência típica 5–15 s.

curl -X POST "https://api.ragjur.ai/api/v1/estrategia-juiz" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"relator":"NANCY ANDRIGHI","tema":"dano moral negativação indevida","fonte":"stj_integras"}'

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno) · 502 (Erro no Elasticsearch ou no modelo de IA)

Anti-alucinação: verifica citações jurisprudenciais de um texto

Extrai citações (REsp, AgInt, RR, HC, súmulas…) e confere no índice. `rapido` usa só Elasticsearch; `google` e `deep` acrescentam busca web (mais lentos). Texto truncado em 50.000 caracteres.

curl -X POST "https://api.ragjur.ai/api/v1/verificar-citacao" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"content":"Conforme decidiu o STJ no REsp 1.987.654/SP, rel. Min. Nancy Andrighi, o dano moral por negativação indevida é in re ipsa.","mode":"rapido"}'

{
  "citations": [
    {
      "text": "REsp 1.987.654/SP",
      "status": "confirmado",
      "details": "Encontrado em stj_integras (Terceira Turma, 2024-05-14)"
    }
  ],
  "summary": {
    "confirmados": 1,
    "suspeitos": 0,
    "naoEncontrados": 0,
    "total": 1
  },
  "mode": "rapido"
}

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Chat jurídico com resposta fundamentada em decisões reais (RAG)

Recupera decisões do tema na `fonte` e responde em prosa citando-as. `historico` mantém o contexto da conversa. Alias: `POST /api/v1/chat-estrategia`.

curl -X POST "https://api.ragjur.ai/api/v1/chat" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno) · 502 (Erro no Elasticsearch ou no modelo de IA)

Alias de `/chat`

curl -X POST "https://api.ragjur.ai/api/v1/chat-estrategia" \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno) · 502 (Erro no Elasticsearch ou no modelo de IA)

Minuta de peça processual fundamentada em precedentes reais

Busca jurimetria e precedentes do tema/lado e gera a minuta com LLM (somente precedentes do índice). Latência 20–90 s.

curl -X POST "https://api.ragjur.ai/api/v1/gerar-peca" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"tipo":"peticao_inicial","tema":"dano moral negativação indevida","fonte":"tjsp_cjsg","fatos":"Cliente teve o nome inscrito no SPC por dívida já quitada; contestou administrativamente sem resposta.","lado":"autor"}'

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno) · 502 (Erro no Elasticsearch ou no modelo de IA)

Classificação direcional em massa (padrões + LLM)

Lotes ≤ 20 executam de forma síncrona; acima disso responde 202 com `job_id` e processa em background. Consulte o progresso em `GET /batch-classify/status?job_id=`. Restrito à chave interna.

curl -X POST "https://api.ragjur.ai/api/v1/batch-classify" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"fonte":"tst_jurisprudencia","tema":"dano_moral","limit":100}'

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Progresso de job ou cobertura de classificação por tema

curl "https://api.ragjur.ai/api/v1/batch-classify/status?fonte=stj_integras" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 404 (Nenhum resultado / recurso não encontrado) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Lista alertas jurimétricos (até 200)

curl "https://api.ragjur.ai/api/v1/alertas" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Cria alerta (webhook HTTPS ou e-mail)

curl -X POST "https://api.ragjur.ai/api/v1/alertas" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"tipo":"taxa_queda","fonte":"stj_integras","busca":"dano moral negativação indevida","threshold":5,"webhook_url":"https://exemplo.com/hooks/ragjur"}'

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Remove alerta

curl -X DELETE "https://api.ragjur.ai/api/v1/alertas?id=..." \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Executa a checagem de todos os alertas (cron)

curl -X POST "https://api.ragjur.ai/api/v1/alertas/check" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Lista monitores do DJEN (Diário de Justiça Eletrônico Nacional)

curl "https://api.ragjur.ai/api/v1/djen" \
  -H "x-api-key: rj_..."

Erros: 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Cria monitor por processo, OAB ou nome de parte

curl -X POST "https://api.ragjur.ai/api/v1/djen" \
  -H "x-api-key: rj_..." \
  -H "Content-Type: application/json" \
  -d '{"cliente_id":"cli_123","estrategia":"oab","numero_oab":"123456","uf_oab":"SP","webhook_url":"https://exemplo.com/hooks/djen"}'

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Remove monitor

curl -X DELETE "https://api.ragjur.ai/api/v1/djen?id=..." \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Publicações capturadas para um cliente

curl "https://api.ragjur.ai/api/v1/djen/publicacoes?cliente_id=..." \
  -H "x-api-key: rj_..."

Erros: 400 (Parâmetro obrigatório ausente ou inválido) · 401 (Sem `x-api-key` ou chave inválida) · 403 (Chave desativada) · 429 (Rate limit excedido (janela deslizante por chave)) · 500 (Erro interno)

Health check (público)

Estado do serviço e do Elasticsearch. Não exige credencial.

curl "https://api.ragjur.ai/api/v1/health"

{
  "status": "ok",
  "service": "ragjur-api",
  "version": "1.0.0",
  "timestamp": "2026-09-15T12:00:00.000Z",
  "elastic": {
    "status": "ok",
    "doc_count": 62412318,
    "latency_ms": 41
  }
}

Erros: 429 (Rate limit excedido (janela deslizante por chave))

Esta especificação (público)

curl "https://api.ragjur.ai/api/v1/openapi.json"

Erros: 429 (Rate limit excedido (janela deslizante por chave))