Comunicação

O Inmetro utiliza web services no padrão REST (Transferência do Estado Representativo), com troca de mensagens no formato XML (eXtensible Markup Language), através da internet, utilizando HTTP e SSL versão 3.0.

Mensagens

As mensagens devem ser assinadas digitalmente de maneira a garantir a integridade dos dados e a autoria da requisição pelo emissor e atender aos seguintes padrões:

• Formato: XML
• Content-type: application/xml
• Codificação: UTF-8
• Imagens: arquivo no formato JPEG com resolução VGA (640x480) ou superior e tamanho máximo de 250Kb codificados com método Base64.

Assinatura

A assinatura digital deverá atender aos seguintes padrões:

• Padrão de assinatura: “XML Digital Signature”, utilizando o formato “Enveloped” (http://www.w3.org/TR/xmldsig-core);
• Função criptográfica assimétrica: RSA (1024-bits)
• Função de “message digest”: SHA-1
• Codificação: Base64

Validação

Para garantir a correta formatação e a integridade das informações enviadas, os arquivos XML são validados pelos XSDs (XML Schema Definition) disponibilizados em cada serviço.

Códigos de retorno

Cada serviço possui uma tabela de códigos de retorno com a descrição de seus códigos. A cada requisição o web service retorna uma mensagem de resposta com status OK e seu código e descrição confirmando o recebimento da solicitação em caso de sucesso ou o status ERRO e seu código e descrição na ocorrência de erros na validação dos dados da requisição.

<retorno>
    <status>OK</status>
    <codigo>200</codigo>
    <mensagem>Requisição recebida com sucesso.</mensagem>
    <erros/>
</retorno>

<retorno>
    <status>ERRO</status>
    <codigo>500</codigo>
    <mensagem>Requisição inválida.</mensagem>
    <erros/>
</retorno>

Ambientes

Foram disponibilizados dois ambientes:

• Produção

  Ambiente para utilização após homologação e liberação pelo Inmetro. A chave pública deverá ser informada previamente.
  URL-AMBIENTE: https://webservice.cronotacografo.rbmlq.gov.br

• Teste / Homologação

  Ambiente para testes e homologação durante o desenvolvimento. Não é necessário informar previamente a chave pública a ser utilizada.
  URL-AMBIENTE: https://webservicedesenv.cronotacografo.inmetro.rs.gov.br

Web services

O Inmetro disponibiliza os seguintes web services: