AnexosDownload de Anexo

Download de Anexo

Faz o download do conteúdo binário de um anexo vinculado a uma transação. Os IDs dos anexos são retornados no array attachments de cada transação no endpoint de extrato.

Formatos suportados:

  • image/png — Screenshots, fotos
  • image/jpeg — Fotos, recibos escaneados
  • application/pdf — Notas fiscais, documentos

Anexos enviados como planilha ou extrato (XLS, XLSX, ODF, OFX — ver CreateAttachmentFileInput.contentType) também podem ser baixados; o Content-Type da resposta reflete o formato original do arquivo.

O comportamento de download é o mesmo independentemente do status do anexo (PROCESSING ou AVAILABLE).

Veja também: Boas Práticas — Anexos para exemplos de download e processamento.

curl -X GET "https://api-sandbox.contasimples.com/attachments/v1/content/example_string" \
  -H "Content-Type: application/json" \
  -H "Signature-Input: example_string" \
  -H "Signature: example_string" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{}
GET
/attachments/v1/content/{attachmentId}
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
path
attachmentIdstring
Required

ID único do anexo, obtido no array attachments da resposta do extrato de cartão.

header
Signature-Inputstring

O que foi assinado e os parâmetros da assinatura, no formato da RFC 9421. Uma credencial com chave pública precisa enviar este header em todas as chamadas, inclusive as de leitura, ou a requisição é recusada com 401. A assinatura cobre os componentes @method, @path e @query, e também content-digest quando houver corpo. created e alg são obrigatórios, e o created vale por 300 segundos. O formato completo, com exemplos, está em Assinatura de Requisições.

header
Signaturestring

A assinatura da base definida pela RFC 9421, em base64, entre : e com o mesmo rótulo usado no Signature-Input, por exemplo sig=:SGVsbG8gd29ybGQ=:. Vai sempre junto com o Signature-Input.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Path Parameters

attachmentIdstring
Required

ID único do anexo, obtido no array attachments da resposta do extrato de cartão.

Headers

Signature-Inputstring

O que foi assinado e os parâmetros da assinatura, no formato da RFC 9421. Uma credencial com chave pública precisa enviar este header em todas as chamadas, inclusive as de leitura, ou a requisição é recusada com 401. A assinatura cobre os componentes @method, @path e @query, e também content-digest quando houver corpo. created e alg são obrigatórios, e o created vale por 300 segundos. O formato completo, com exemplos, está em Assinatura de Requisições.

Signaturestring

A assinatura da base definida pela RFC 9421, em base64, entre : e com o mesmo rótulo usado no Signature-Input, por exemplo sig=:SGVsbG8gd29ybGQ=:. Vai sempre junto com o Signature-Input.

Responses

Conteúdo binário do anexo. O formato é indicado pelo header Content-Type da resposta.