Anexos

O upload de ficheiros no Sendaki segue um fluxo de 3 passos, desenhado para que o ficheiro nunca passe pelos teus servidores — vai directo do teu browser ou backend para o armazenamento do Sendaki.

Pede uma URL de upload

POST /v1/attachments/presign devolve uma URL temporária de upload e um attachment_id.

Faz o upload directo

PUT para a URL devolvida, com o conteúdo do ficheiro.

Referencia o attachment_id no envio

Usa o attachment_id no campo attachments de POST /v1/emails.

1. Gerar a URL de upload

curl -X POST https://api.sendaki.tech/v1/attachments/presign \
  -H "Authorization: Bearer {a_tua_api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "fatura-001.pdf",
    "content_type": "application/pdf"
  }'

201 Created
{
  "upload_url": "https://storage.sendaki.tech/uploads/...?X-Signature=...",
  "attachment_id": "att_9f1c2e7b4a3d4c8f8e6a1b2c3d4e5f60",
  "expires_in": 3600
}

A URL de upload expira em 1 hora.

Content types comuns

Tipo de ficheiro	`content_type`
PDF	`application/pdf`
Word (.docx)	`application/vnd.openxmlformats-officedocument.wordprocessingml.document`
Excel (.xlsx)	`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
Imagem JPEG	`image/jpeg`
Imagem PNG	`image/png`
Texto	`text/plain`
ZIP	`application/zip`
Genérico	`application/octet-stream` (default)

2. Upload directo

curl -X PUT "{upload_url_devolvida}" \
  -H "Content-Type: application/pdf" \
  --data-binary @fatura-001.pdf

const { upload_url, attachment_id } = await fetch(
  "https://api.sendaki.tech/v1/attachments/presign",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${SENDAKI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ filename: "fatura-001.pdf", content_type: "application/pdf" }),
  },
).then((r) => r.json());

await fetch(upload_url, {
  method: "PUT",
  headers: { "Content-Type": "application/pdf" },
  body: ficheiro, // File ou Blob
});

// Guarda o attachment_id para usar em POST /v1/emails

3. Enviar o email com o anexo

Usa o attachment_id devolvido no passo 1 no campo attachments — ver Enviar emails.

{
  "attachments": [
    {
      "filename": "fatura-001.pdf",
      "attachment_id": "att_9f1c2e7b4a3d4c8f8e6a1b2c3d4e5f60",
      "content_type": "application/pdf"
    }
  ]
}

Download de um anexo

GET /v1/attachments/download gera uma URL temporária de download (expira em 1 hora):

curl "https://api.sendaki.tech/v1/attachments/download?attachment_id=att_9f1c2e7b4a3d4c8f8e6a1b2c3d4e5f60" \
  -H "Authorization: Bearer {a_tua_api_key}"

Apagar um anexo

Apagar é permanente e irreversível — usa apenas para uploads abandonados (email nunca enviado).

curl -X DELETE https://api.sendaki.tech/v1/attachments \
  -H "Authorization: Bearer {a_tua_api_key}" \
  -H "Content-Type: application/json" \
  -d '{"attachment_id": "att_9f1c2e7b4a3d4c8f8e6a1b2c3d4e5f60"}'

Um attachment_id só pode ser descarregado ou apagado pela organização que o criou — usar um id de outra organização devolve 404.

Ver a referência completa em Attachments.

Começar

Guias

Essenciais

1. Gerar a URL de upload

Content types comuns

2. Upload directo

3. Enviar o email com o anexo

Download de um anexo

Apagar um anexo

​1. Gerar a URL de upload

​Content types comuns

​2. Upload directo

​3. Enviar o email com o anexo

​Download de um anexo

​Apagar um anexo

1. Gerar a URL de upload

Content types comuns

2. Upload directo

3. Enviar o email com o anexo

Download de um anexo

Apagar um anexo