Download de Certificado QRcode pix

Esta API tem como objetivo de realizar download de certificados para QRcode pix.

Observações:

  • No máximo 1 chamada com sucesso à JDPI por dia de negócio. O dia de negócio reseta às 00:00 horário de Brasília (03:00 UTC), calculado sempre em UTC fixo — não depende do fuso do servidor.
  • Caso já tenha realizado o download no mesmo dia, pode enviar o header If-None-Match com o valor do ETag recebido numa resposta anterior para economizar banda — se o conteúdo não mudou, recebe 304 Not Modified sem corpo. Isso é opcional: se o cliente não enviar, sempre recebe 200 com o conteúdo completo.

Request


Header

Sem parâmetros de rota, query string ou corpo — é um GET simples.

GET
https://sandbox.openfinance.celcoin.dev/pix-indirect/v1/certificate/download

HeaderObrigatórioDescriçãoExemplo
AuthorizationSimBearer token JWT do webserviceBearer eyJhbGciOi...
If-None-MatchNãoETag recebido numa resposta anterior — se o conteúdo não mudou, retorna 304"a1b2c3d4"

Response 200

Corpo binário (application/zip), transmitido via stream (FileStreamResult). Nome sugerido do arquivo: certificates_latest.zip.


HeaderDescrição
Content-Typeapplication/zip
ETag
Etag lógico para o conteúdo atual — pode ser reenviado em If-None-Match na próxima chamada

304 Not Modified

Sem corpo. Retornado quando o If-None-Match enviado bate com o etag atual do certificado em cache.


HeaderDescrição
ETag
Mesmo etag informado pelo cliente

503 Service Unavailable

Certificado indisponível — sem cache local.

{
  "code": "CERT001",
  "message": "Certificado indisponível no momento."
}

Erros

StatusCódigoMensagem
503CERT001Certificado indisponível no momento.
500PIE001Houve um erro interno na api.


Did this page help you?