ForHosting KIT · Ferramentas para dev

Analise uma referência Docker: registro, repositório, tag ou digest

Cole uma referência de imagem Docker e receba suas partes relevantes como JSON estruturado.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

O analisador separa um registro explícito, inclusive com porta opcional, do caminho do repositório e de uma tag ou um digest de conteúdo opcionais. Ele entende por que os dois-pontos em registry.example.com:5000 não iniciam uma tag e por que aqueles após o nome da imagem iniciam. Referências malformadas geram um erro claro, em vez de campos parciais enganosos. Nenhum registro é consultado, e padrões omitidos como Docker Hub ou latest não são inventados silenciosamente.

Separe cada parte sem presumir padrões ocultos

Uma referência de imagem Docker pode ser curta como alpine ou detalhada como registry.example.com:5000/platform/api:2026.07. À primeira vista, tanto a porta do registro quanto a tag da imagem usam dois-pontos; portanto, dividir somente pela pontuação produz resultados errados. Este analisador primeiro isola o digest e depois examina apenas o último segmento do caminho em busca de uma tag. Ele reconhece o primeiro componente separado por barra como registro explícito quando esse componente é localhost, contém um ponto, inclui os dois-pontos de uma porta ou representa um endereço IPv6 entre colchetes. Tudo depois desse componente forma o caminho do repositório. A saída preserva somente o que a entrada declara. Para alpine, o repositório é alpine e não há campos de registro ou tag. O analisador não substitui por docker.io, não acrescenta o namespace convencional library e não presume latest. Isso deixa o resultado adequado para análise de configuração, verificações de política e ferramentas de migração nas quais um valor explícito precisa continuar diferente de um padrão aplicado pelo cliente.

Trate corretamente tags, digests, portas e caminhos

Tags e digests identificam imagens de maneiras diferentes. Uma tag é um rótulo móvel como stable, 1.4.2 ou release_candidate, enquanto um digest é um identificador baseado no conteúdo, escrito após uma arroba como algoritmo e valor. O analisador devolve essas informações em campos separados e também aceita uma referência que contenha ambas, pois as ferramentas Docker podem usar um nome com tag qualificado por um digest. Caminhos de repositório podem conter vários componentes em minúsculas, com os separadores permitidos pelas regras familiares de nomes Docker. Hosts de registro são validados separadamente, inclusive portas numéricas de 1 a 65535 e formatos IPv6 em minúsculas entre colchetes. Algoritmos e valores de digest precisam seguir suas sintaxes, e o valor deve ter comprimento significativo. Não há tentativa de resolver uma tag, confirmar a existência de um digest ou verificar se as credenciais permitem baixar a imagem. Trata-se somente de análise sintática, por isso os resultados permanecem determinísticos, privados e disponíveis sem acesso à rede.

Rejeite entradas ambíguas antes da automação

Um analisador permissivo pode ser perigoso na automação de implantação, pois um erro de digitação pode apontar para uma imagem diferente da pretendida. Esta capacidade rejeita valores vazios, espaços no início, no fim ou no meio, esquemas de URL, separadores de digest repetidos, segmentos de caminho vazios, tags malformadas, portas de registro inválidas, nomes de repositório com maiúsculas e expressões de digest incorretas. Ela também limita o tamanho da referência completa e do repositório para manter o trabalho controlado. A validação retorna um único erro claro de entrada inválida, e não um objeto parcial que pareça confiável. Use esse comportamento na entrada de uma tarefa de CI, de um editor de manifestos, de um importador de inventário de imagens ou de um auxiliar de política de admissão. Um resultado válido pode ser encaminhado conforme a presença de registro, tag ou digest; um resultado inválido interrompe o fluxo cedo. A ferramenta não afirma que um repositório ou uma imagem sintaticamente válidos existem; isso exige acesso e autenticação no registro. A execução no navegador é local, e o uso da API custa US$ 0,002 por referência.

Casos de uso

Validar configurações de implantação

Rejeite referências de imagem malformadas antes que um manifesto chegue à compilação, implantação ou política de admissão.

Montar um inventário de imagens

Separe registros, caminhos de repositório, tags e digests imutáveis para relatórios ou migrações sem consultar registros.

Aplicar uma política de nomes de imagem

Verifique se uma referência usa um registro aprovado, um digest obrigatório ou uma tag mutável proibida.

Perguntas frequentes

O analisador adiciona docker.io ou library automaticamente?

Não. Ele informa apenas componentes explícitos; assim, um registro omitido continua ausente e o repositório é preservado como foi escrito.

Uma imagem sem tag recebe a tag latest?

Não. O campo de tag é omitido quando a entrada não tem tag. Padrões do cliente Docker não fazem parte do texto analisado.

Uma referência pode conter uma tag e um digest?

Sim. Quando ambos estão sintaticamente presentes, o resultado inclui os dois campos sem descartar nenhum qualificador.

Nomes de repositório podem ter letras maiúsculas?

Não. Componentes de repositório Docker devem estar em minúsculas. Tags podem conter maiúsculas porque sua sintaxe é diferente.

A ferramenta verifica se a imagem existe?

Não. Ela apenas valida e separa a sintaxe. Não há consulta a registro, autenticação, download ou solicitação de rede.

Quanto custa usar a API?

O preço-base é US$ 0,002 por referência. A versão para navegador roda localmente sem enviar a referência a um registro.

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/dev2/docker-tag-parse

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/dev2/docker-tag-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"registry.example.com:5000/team/service:2026.07"}'

const res = await fetch("https://api.kit.forhosting.com/dev2/docker-tag-parse", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "registry.example.com:5000/team/service:2026.07"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev2/docker-tag-parse",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "registry.example.com:5000/team/service:2026.07"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/docker-tag-parse", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"registry.example.com:5000/team/service:2026.07"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"registry.example.com:5000/team/service:2026.07"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/docker-tag-parse", 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

{
  "text": "registry.example.com:5000/team/service:2026.07"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev2.docker_tag_parse",
  "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,002

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.

Ver a documentação completa do KIT →