ForHosting KIT · Ferramentas para dev

O que essa regex faz?

Recebeu uma regex enigmática num código herdado e não sabe o que ela filtra? Cole a expressão e a IA explica em português: o que cada trecho — âncoras, classes, quantificadores — faz e o que o padrão aceita como um todo, com exemplos do que casa e do que é rejeitado.

● Estávelpor itemUS$ 0,003

Executar — US$ 0,003 + US$ 0,0135/item Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Quebra o padrão em pedaços

A explicação percorre a expressão da esquerda para a direita e nomeia cada peça: o acento circunflexo que ancora no começo, o \d que é um dígito, o {3} que repete três vezes, o grupo entre parênteses que captura um pedaço. Em vez de um bloco de símbolos, você lê uma frase: “começa com três letras, seguidas de um hífen opcional e quatro dígitos”. Entender parte por parte é o que permite alterar a regex com segurança, sem quebrar o que já funcionava.

Mostra o que casa e o que não casa

Saber a teoria não basta; ver a prática convence. A explicação vem com exemplos: quais entradas o padrão aceita e, tão importante quanto, quais ele recusa. Uma regex de e-mail que casa “[email protected]” mas rejeita “ana@@empresa” mostra na hora onde ela é rígida e onde é frouxa. Esses casos concretos revelam se o padrão faz o que o código espera — ou se deixa passar exatamente o formato que estava te dando dor de cabeça em produção.

Onde mora o perigo: ganância e catástrofe

Explicar também expõe armadilhas. Um quantificador ganancioso pode capturar muito mais do que você imagina, engolindo o texto até o último caractere possível. Pior: certos padrões com repetição aninhada sofrem de “backtracking catastrófico” — travam o processamento com uma entrada maliciosa, o que abre brecha de negação de serviço. Ao ler a expressão em português, esses riscos ficam visíveis antes de irem para produção, e você decide se aperta o padrão ou troca de abordagem.

Quanto custa entender uma regex

A explicação é gerada por IA e cobrada por uso: US$ 0,003 por chamada mais US$ 0,0135 por expressão, em dólares americanos, com o preço publicado aqui — algo perto de US$ 0,017 por regex explicada. Sem assinatura e sem plano: paga quem usa, e a compra é direta, sem cadastro. Não existe versão grátis dessa leitura, porque cada pedido roda num modelo de linguagem de verdade no servidor.

Casos de uso

Mexer num código sem documentação

O dev assumiu um sistema legado da Distribuidora Horizonte Verde e achou uma regex de validação sem um comentário. Antes de tocar nela, cola a expressão, lê a explicação e descobre que ela recusa CEP sem hífen — a causa dos cadastros que falhavam.

Revisar o pull request de um colega

No code review aparece uma regex densa. Em vez de aprovar no escuro, quem revisa cola o padrão, entende o que ele casa e aponta que um caractere especial ficou de fora — antes de virar bug.

Aprender regex com casos reais

A estagiária quer aprender a notação de verdade. Pega expressões que encontra no código da empresa, lê a explicação parte por parte e monta seu próprio repertório, com exemplos do dia a dia em vez de exercício de manual.

Perguntas frequentes

Ela explica qualquer expressão, por mais longa que seja?

Sim, a proposta é destrinchar padrões complexos — justamente os que ninguém quer ler na mão. Padrões muito extensos consomem um pouco mais de processamento, mas a explicação sai peça por peça do mesmo jeito.

Também aponta se a regex tem algum problema?

Quando o padrão traz risco conhecido — um quantificador ganancioso que captura demais ou uma estrutura sujeita a travamento por backtracking — a explicação costuma sinalizar. Ainda assim, ela descreve o que a expressão faz; a decisão de reescrever é sua.

Preciso dizer a linguagem da regex?

Ajuda. Um mesmo símbolo pode ter leitura diferente entre o regex de JavaScript, PCRE e POSIX. Informando onde a expressão roda, a explicação fica precisa nos detalhes que variam de dialeto para dialeto.

Qual a diferença para gerar uma regex?

São caminhos opostos: aqui você já tem a expressão e quer entendê-la; na geração, você descreve o objetivo e recebe o padrão. Muita gente usa os dois — gera, e depois pede a explicação para conferir se ficou como queria.

A regex que eu colo fica guardada?

O padrão é processado no servidor apenas para gerar a explicação da sua tarefa. A expressão em si raramente é sensível, mas, se ela vier embutida com algum dado real, o hábito seguro é enviar só o padrão, sem o contexto que não faz falta para a leitura.

Quanto custa e como pago?

US$ 0,003 por chamada mais US$ 0,0135 por expressão, pagos por uso via PayPal, sem mensalidade e sem cadastro. O valor é sempre em dólares americanos, como publicado na página; por enquanto não há Pix nem boleto.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/dev/regex-explain

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/dev/regex-explain \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/dev/regex-explain", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/regex-explain",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/regex-explain", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/regex-explain", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.regex_explain",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,003

por itemUS$ 0,0135

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.
`422`	`task_failed`	A tarefa falhou do nosso lado. Você não paga nada por ela.

Ver a documentação completa do KIT →