Ir para o conteúdo

Cache do Termo de Autorização

Todo Termo de Autorização válido é armazenado em um mecanismo interno de cache. Quando o cliente envia um Termo de Autorização repetido e que ainda esteja na situação validado/autenticado, o Integra Contador vai responder com o status code 304 (not modified) como uma resposta de sucesso.

Essa resposta ao cliente, se faz necessária para comunicar que não houve modificação da requisição anterior e que o Termo de Autorização ainda está válido, pois o token não expirou. Portanto, o token "autenticar_procurador_token" pode continuar sendo utilizado nas chamadas da API.

Atenção

É importante a aplicação cliente utilizar esse recurso de cache. Esse mecanismo é seguro e ajuda a otimizar o ambiente computacional.

Status Code

304 - Not Modified

Tempo de Expiração

Válido por 12 horas a partir da data da autenticação realizada com sucesso. A data e hora está configurada com o fuso horário (UTC/GMT -03:00) America/Sao_Paulo dos servidores do Serpro.

Response Headers

A aplicação cliente pode utilizar os headers abaixo para recuperar o token e adicionar a lógica para enviar um novo Termo de Autorização assinado digitalmente quando expira a validade do token de autenticação.

Header Descrição
cache-control Nome do mecanismo de cache.
etag Contém o token autenticar_procurador_token em cache.
expires Data e hora da expiração do token.

Exemplo do Response Headers

cache-control: termo_autorizacao

etag: "autenticar_procurador_token:ab87df0b-6d08-3d78-13d2-d474b90b05f3"

expires: Sat, 15 Oct 2022 21:16:18 GMT

O expires no padrão da especificação RFC 7231, sessão 7.1.1.2: Date:

  • Dia da semana de (segunda-feira até domingo), ex. "Mon", "Tue", "Wed", "Thu", "Fri", "Sat", ou "Sun".
  • Um dia em número de 2 dígitos, ex. "04" ou "23".
  • Um mês de (Janeiro até Dezembro), ex. "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec".
  • Um ano em número de 4 dígitos, ex. "2022" ou "2023".
  • Uma hora em número de 2 dígitos, ex. "09" ou "23".
  • Minutos em número de 2 dígitos, ex. "04" ou "59".
  • Segundos em número de 2 dígitos, ex. "04" ou "59".
  • GMT: datas deste protocolo são expressadas em GMT.

Exemplo de resposta com o status 304

Response Body (no content)

No content significa que não é enviado um json com conteúdo de resposta.