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
| Header | Obrigatório | Descrição | Exemplo |
|---|---|---|---|
| Authorization | Sim | Bearer token JWT do webservice | Bearer eyJhbGciOi... |
| If-None-Match | Não | ETag 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.
| Header | Descrição |
|---|---|
| Content-Type | application/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.
| Header | Descriçã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
| Status | Código | Mensagem |
|---|---|---|
| 503 | CERT001 | Certificado indisponível no momento. |
| 500 | PIE001 | Houve um erro interno na api. |
Updated about 1 hour ago
Did this page help you?