{"openapi":"3.1.0","info":{"title":"AcheiSST — API pública de SST","version":"1.0.0","description":"Consulta de CA de EPI na base oficial do CAEPI (Ministério do Trabalho e Emprego), licitações de SST abertas no PNCP e vagas de SST em concursos públicos. Só leitura, sem autenticação. O AcheiSST reproduz as bases oficiais: a consulta oficial e o edital são a palavra final.","contact":{"name":"AcheiSST","url":"https://www.acheisst.com.br/api-publica"},"termsOfService":"https://www.acheisst.com.br/terms"},"servers":[{"url":"https://www.acheisst.com.br"}],"paths":{"/api/v1/ca/{numero}":{"get":{"operationId":"getCA","summary":"Consultar um CA de EPI pelo número","description":"Use quando o usuário perguntar se um CA (Certificado de Aprovação) de EPI está válido, vencido, suspenso ou cancelado, quem é o fabricante, até quando vale ou para que o EPI foi aprovado. Recebe o número do CA, só os dígitos.","parameters":[{"name":"numero","in":"path","required":true,"description":"Número do CA, só os dígitos (ex.: 54003).","schema":{"type":"string","pattern":"^[0-9]{1,9}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CA"}}}},"400":{"description":"Número inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"CA não está na base.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"Base indisponível.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/ca":{"get":{"operationId":"searchCA","summary":"Buscar CAs por equipamento ou fabricante","description":"Use quando o usuário quiser achar CAs de EPI pelo nome do equipamento (ex.: luva nitrílica, respirador PFF2, botina) ou pelo fabricante, sem saber o número. Devolve os válidos primeiro.","parameters":[{"name":"q","in":"query","required":true,"description":"Nome do equipamento, fabricante, referência ou começo do número.","schema":{"type":"string","minLength":2,"maxLength":80}},{"name":"limite","in":"query","required":false,"description":"Quantos itens devolver (1 a 50).","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuscaCA"}}}},"400":{"description":"Busca vazia.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/licitacoes":{"get":{"operationId":"listTenders","summary":"Licitações de SST abertas no PNCP","description":"Use quando o usuário procurar licitações, pregões ou editais públicos de SST abertos: PCMSO, exames ocupacionais, PGR, LTCAT, laudos, treinamento de NR ou compra de EPI. Filtra por estado e por palavra do objeto.","parameters":[{"name":"uf","in":"query","required":false,"description":"Sigla do estado, como SP ou MG. Sem ela, o Brasil inteiro.","schema":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]}},{"name":"q","in":"query","required":false,"description":"Palavras que precisam aparecer no objeto, órgão ou município (ex.: pcmso, luva, brigada).","schema":{"type":"string","maxLength":120}},{"name":"categoria","in":"query","required":false,"description":"Assunto da licitação.","schema":{"type":"string","enum":["pcmso-medicina-do-trabalho","pgr-ltcat-laudos","treinamento-nr","epi"]}},{"name":"limite","in":"query","required":false,"description":"Quantos itens devolver (1 a 50).","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Licitacoes"}}}},"400":{"description":"Filtro inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/api/v1/vagas":{"get":{"operationId":"listJobs","summary":"Vagas de SST em concursos com inscrição aberta","description":"Use quando o usuário procurar vagas, concursos ou seleções públicas para técnico ou engenheiro de segurança do trabalho, médico ou enfermeiro do trabalho. Só vagas com inscrição aberta ou por abrir.","parameters":[{"name":"uf","in":"query","required":false,"description":"Sigla do estado, como SP ou MG. Sem ela, o Brasil inteiro.","schema":{"type":"string","enum":["AC","AL","AP","AM","BA","CE","DF","ES","GO","MA","MT","MS","MG","PA","PB","PR","PE","PI","RJ","RN","RS","RO","RR","SC","SP","SE","TO"]}},{"name":"cargo","in":"query","required":false,"description":"Cargo: tecnico (Técnico de Segurança do Trabalho), engenheiro (Engenheiro de Segurança do Trabalho), medico (Médico do Trabalho), enfermeiro (Enfermeiro do Trabalho). Outro texto procura as palavras no nome do cargo.","schema":{"type":"string","maxLength":80}},{"name":"limite","in":"query","required":false,"description":"Quantos itens devolver (1 a 50).","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vagas"}}}},"400":{"description":"Filtro inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"schemas":{"Erro":{"type":"object","properties":{"erro":{"type":"string"}},"required":["erro"]},"CA":{"type":"object","properties":{"ca":{"type":"integer","description":"Número do CA."},"equipamento":{"type":["string","null"]},"fabricante":{"type":["string","null"],"description":"Titular do CA (fabricante ou importador)."},"cnpj":{"type":["string","null"],"description":"CNPJ do titular, formatado."},"situacao_no_arquivo":{"type":"string","description":"Situação do CA no arquivo do MTE (VÁLIDO, VENCIDO, SUSPENSO, CANCELADO)."},"estado":{"type":"string","enum":["valido","vencido","vencido-depois","cancelado","suspenso"],"description":"Estado hoje: \"vencido-depois\" é o CA que estava válido no arquivo mas cuja validade já passou."},"estado_texto":{"type":"string","description":"Rótulo do estado em português."},"validade":{"type":["string","null"],"description":"Validade do CA, AAAA-MM-DD."},"url":{"type":"string","description":"Página do CA no AcheiSST."},"descricao":{"type":["string","null"]},"aprovado_para":{"type":["array","null"],"items":{"type":"string"},"description":"Contra o que o EPI protege, nos termos do certificado."},"restricoes":{"type":["array","null"],"items":{"type":"string"},"description":"Restrições de uso escritas no certificado."},"normas":{"type":["array","null"],"items":{"type":"string"},"description":"Normas técnicas do ensaio."},"consulta_oficial":{"type":"string","description":"Consulta oficial do MTE."},"fonte":{"type":"object","additionalProperties":true,"description":"De onde vem o dado."},"aviso":{"type":"string"}}},"BuscaCA":{"type":"object","properties":{"busca":{"type":"string"},"total":{"type":"integer"},"itens":{"type":"array","items":{"type":"object","properties":{"ca":{"type":"integer","description":"Número do CA."},"equipamento":{"type":["string","null"]},"fabricante":{"type":["string","null"],"description":"Titular do CA (fabricante ou importador)."},"cnpj":{"type":["string","null"],"description":"CNPJ do titular, formatado."},"situacao_no_arquivo":{"type":"string","description":"Situação do CA no arquivo do MTE (VÁLIDO, VENCIDO, SUSPENSO, CANCELADO)."},"estado":{"type":"string","enum":["valido","vencido","vencido-depois","cancelado","suspenso"],"description":"Estado hoje: \"vencido-depois\" é o CA que estava válido no arquivo mas cuja validade já passou."},"estado_texto":{"type":"string","description":"Rótulo do estado em português."},"validade":{"type":["string","null"],"description":"Validade do CA, AAAA-MM-DD."},"url":{"type":"string","description":"Página do CA no AcheiSST."}}}},"fonte":{"type":"object","additionalProperties":true,"description":"De onde vem o dado."},"aviso":{"type":"string"}}},"Licitacoes":{"type":"object","properties":{"total":{"type":"integer","description":"Quantas casam com o filtro (antes do limite)."},"itens":{"type":"array","items":{"type":"object","properties":{"titulo":{"type":"string"},"objeto":{"type":"string"},"tipo":{"type":"string"},"categorias":{"type":"array","items":{"type":"string"}},"orgao":{"type":["string","null"]},"municipio":{"type":["string","null"]},"uf":{"type":["string","null"]},"modalidade":{"type":["string","null"]},"valor_estimado":{"type":["number","null"],"description":"Em reais, quando o órgão informa."},"abertura":{"type":["string","null"],"description":"Início do recebimento de propostas, hora de Brasília."},"encerramento":{"type":["string","null"],"description":"Fim do recebimento de propostas, hora de Brasília."},"estado":{"type":"string","enum":["vai-abrir","aberta","sem-prazo","encerrada"]},"situacao":{"type":["string","null"],"description":"Prazo em palavras, como \"3 dias para encerrar\"."},"url":{"type":["string","null"],"description":"Página da licitação no AcheiSST."},"link_pncp":{"type":["string","null"],"description":"Edital no PNCP."},"link_origem":{"type":["string","null"],"description":"Sistema de compras do órgão."},"id_pncp":{"type":["string","null"]}}}},"fonte":{"type":"object","additionalProperties":true,"description":"De onde vem o dado."},"atualizado_em":{"type":["string","null"]},"aviso":{"type":"string"}}},"Vagas":{"type":"object","properties":{"total":{"type":"integer","description":"Quantas casam com o filtro (antes do limite)."},"itens":{"type":"array","items":{"type":"object","properties":{"cargo":{"type":"string"},"orgao":{"type":"string"},"certame":{"type":["string","null"]},"uf":{"type":"string"},"cidade":{"type":["string","null"]},"salario_do_cargo":{"type":["number","null"],"description":"Salário deste cargo no edital, em reais."},"faixa_salarial_do_concurso":{"type":["object","null"],"description":"Menor e maior salário do concurso inteiro (todos os cargos).","properties":{"de":{"type":["number","null"]},"ate":{"type":["number","null"]}}},"vagas_no_concurso":{"type":["integer","null"],"description":"Total de vagas do concurso inteiro."},"inscricoes_de":{"type":["string","null"]},"inscricoes_ate":{"type":"string"},"prazo":{"type":["string","null"]},"url":{"type":"string"},"link_edital":{"type":["string","null"]},"link_divulgacao":{"type":["string","null"]},"encontrado_em":{"type":["string","null"]}}}},"fonte":{"type":"object","additionalProperties":true,"description":"De onde vem o dado."},"atualizado_em":{"type":["string","null"]},"aviso":{"type":"string"}}}}}}