ForHosting KIT · PDF e documentos

Identifique o tamanho do papel pelas medidas

O identificador transforma largura e altura medidas no nome de um formato padrão reconhecido.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe as dimensões em milímetros ou polegadas para compará-las com os formatos ISO A, B e C e com tamanhos de escritório norte-americanos comuns. Medidas nas orientações retrato e paisagem são aceitas. Uma pequena tolerância padrão considera variações normais de medição e corte, enquanto uma tolerância personalizada oferece controle explícito a fluxos automatizados. Se nenhum padrão tiver os dois lados dentro desse limite, a solicitação retorna um erro em vez de sugerir uma correspondência enganosa.

Meça a folha e escolha a unidade correta

Meça as duas bordas retas do papel, informe os valores como largura e altura e selecione milímetros ou polegadas. A ordem não impede a correspondência: uma folha paisagem de 297 por 210 mm e uma folha retrato de 210 por 297 mm são comparadas às mesmas dimensões padrão. Use a folha física já cortada, não a área imprimível mostrada por um aplicativo ou driver de impressora. Áreas imprimíveis excluem margens e, portanto, não representam o papel real. A tolerância padrão é 2 mm para entradas métricas e 0.08 polegadas para entradas imperiais. Ela absorve a precisão comum de uma régua e pequenas variações de corte sem confundir formatos diferentes. Largura e altura precisam ser números finitos positivos. Valores decimais são aceitos, o que ajuda quando uma régua, um scanner ou um sistema de produção informa frações de polegada. O resultado preserva a orientação enviada, mas apresenta o padrão em suas dimensões convencionais de retrato, deixando a distinção clara para sistemas posteriores.

Entenda como a correspondência mais próxima é escolhida

Cada par informado é convertido internamente em milímetros e comparado com uma tabela fixa de ISO A0 a A10, ISO B0 a B10, ISO C0 a C10 e formatos norte-americanos comuns, como Letter, Legal, Tabloid, Executive, Statement, Folio, Junior Legal e Government Letter. A comparação ignora a orientação ao ordenar a borda curta e a longa. Um candidato só é aceito quando o erro absoluto de cada borda não ultrapassa a tolerância. Entre os candidatos válidos, o algoritmo minimiza primeiro o maior erro de borda e depois o erro combinado, gerando uma escolha determinística. A resposta traz o nome do papel, a família, a norma, a orientação detectada, as dimensões convencionais, as diferenças das bordas e a tolerância efetiva. Esses detalhes permitem auditar a decisão, em vez de receber somente um rótulo. A tabela e a aritmética são locais e fixas: não há consulta de rede, classificação probabilística, catálogo externo variável nem leitura oculta de metadados.

Defina a tolerância e trate medidas rejeitadas

A tolerância representa a discrepância máxima permitida para cada borda individualmente; ela não é uma porcentagem nem uma margem combinada. Uma tolerância de 1 mm exige que tanto a diferença da borda curta quanto a da longa seja de 1 mm ou menos. Use um valor mais rigoroso quando as dimensões vierem de metadados confiáveis ou de equipamentos de produção calibrados. Adote um valor um pouco maior para medições manuais, digitalizações com recorte incerto ou papel que possa ter sido aparado, mas mantenha-o pequeno o bastante para preservar o significado de uma identificação padrão. Se nenhum candidato for aceito, a capacidade retorna um erro de entrada informando que não existe formato padrão dentro da tolerância escolhida. Essa falha é intencional: ela diferencia material personalizado, unidade incorreta, erro de medição ou corte excessivo de um formato reconhecido. Sistemas automatizados devem solicitar nova conferência ou encaminhar o item como papel personalizado, sem atribuir silenciosamente o padrão numericamente mais próximo a qualquer distância.

Identificar uma folha desconhecida

Meça folhas soltas de um arquivo ou estoque e descubra o nome provável do formato ISO ou norte-americano.

Normalizar a entrada de documentos

Converta medidas de scanners ou operadores em rótulos consistentes antes do encaminhamento, armazenamento ou processamento de impressão.

Validar dimensões de produção gráfica

Confira se o material aparado continua próximo do padrão desejado e rejeite medidas fora de uma tolerância explícita.

Quanto custa uma solicitação?

O preço da API é US$ 0,002 por solicitação. O mesmo cálculo determinístico pode ser executado gratuitamente no navegador.

Posso informar dimensões em paisagem?

Sim. A correspondência independe da orientação, e a resposta informa separadamente se a largura e a altura enviadas representam retrato ou paisagem.

Quais tamanhos de papel são reconhecidos?

A tabela fixa inclui ISO A0–A10, B0–B10, C0–C10 e os formatos norte-americanos Letter, Legal, Tabloid, Executive, Statement, Folio, Junior Legal e Government Letter.

Qual tolerância é usada por padrão?

O padrão é 2 mm para entradas em milímetros ou 0.08 polegadas para entradas em polegadas. Você pode fornecer outra tolerância não negativa na unidade selecionada.

Por que minhas dimensões retornaram um erro?

Um rótulo só é retornado quando as diferenças das duas bordas cabem na tolerância. O erro evita dar um nome enganoso a uma folha personalizada, mal medida ou informada na unidade errada.

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.

POSThttps://api.kit.forhosting.com/doc/paper-size-from-dimensions

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

curl -X POST https://api.kit.forhosting.com/doc/paper-size-from-dimensions \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":210,"height":297}'
{
  "width": 210,
  "height": 297
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.paper_size_from_dimensions",
  "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.

por chamadaUS$ 0,002

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

max_mb25
max_pages200
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →