GUIAS / CLASSIFICAÇÃO

Cada questão, no seu contexto.

O tópico certo depende do edital, do cargo e da evidência disponível.

Entrada

Você fornece edital, prova, gabarito e cargo. O processamento preserva a redação literal do programa, o número da questão e a origem. Gabarito preliminar e definitivo são versões diferentes.

Upload em três etapas

  1. POST /uploads: informe purpose, content_type, byte_size e sha256. Receba upload_id, URL temporária e headers.
  2. Faça PUT do PDF na URL assinada, usando exatamente os headers retornados, sem enviar a chave da API ao storage.
  3. POST /uploads/{id}/complete: finalize e acompanhe a verificação. Apenas uploads ready podem entrar no job. Arquivos ficam sujeitos a tipo real, tamanho, hash, malware e autorização.

Limite proposto: PDF de até 25 MB por arquivo. A revisão de direitos e os limites de páginas são independentes do limite de bytes. A API não aceita uma URL arbitrária para baixar documentos.

Orçamento por componente

POST /quotes
{
  "sku": "Q06",
  "input": {
    "edict_upload_id": "upl_edital_demo",
    "exam_upload_id": "upl_prova_demo",
    "answer_key_upload_id": "upl_gabarito_demo",
    "position_label": "Analista — Administração",
    "sharing_mode": "private",
    "language": "pt-BR"
  }
}

Q06 mede itens classificados; extração da prova e estruturação de um programa novo são discriminadas na cotação. Documentos já processados não são cobrados de novo como trabalho novo. Confirme o teto antes de enviar o job.

POST /classification-jobs
{
  "input": {
    "edict_upload_id": "upl_edital_demo",
    "exam_upload_id": "upl_prova_demo",
    "answer_key_upload_id": "upl_gabarito_demo",
    "position_label": "Analista — Administração",
    "sharing_mode": "private"
  },
  "quote_id": "quote_demo",
  "max_credits": 3300
}

Estados que preservam a incerteza

StatusComo interpretar
supported_matchHá correspondência sustentada no escopo; conferir estado de revisão e evidências.
ambiguousMais de uma interpretação plausível; precisa de análise.
no_supported_matchNão foi encontrada correspondência sustentada. Indício para revisão, não conclusão de ilegalidade.
insufficient_extractionO texto ou algum componente da questão não pôde ser extraído com qualidade.
review_requiredA política exige revisão antes de aceitar a relação.

Um relatório completo também mostra as lacunas

Compare expected_items e extracted_items. Não trate um arquivo incompleto como prova totalmente analisada. Model_version e syllabus_revision permitem reconstruir o resultado. O artefato indicado no job segue o schema ClassificationResult.

Privado ou contribuição pública

private é o modo indicado para materiais do cliente. public_contribution exige rights_attestation_id e revisão dos direitos de uso, redistribuição e treinamento. Pagamento pelo processamento não concede permissão de revenda ou treino sobre o material.

Contrato proposto · atualizado em 01/11/2026Planejar integração ↗