Receber e-mails: Anexos
Fazer upload de anexo
Envie um arquivo antes de mandar o e-mail. Use o compose_uid retornado em send_email, reply, forward ou schedule_send.
https://g.sendcorex.com/v1command: upload_attachmentSem compose_uid, um novo é criado. Envie-o de volta com os próximos arquivos do mesmo e-mail. Cada arquivo é verificado antes de ser salvo.
Para arquivos avulsos, você também pode pular esta etapa e enviá-los inline em attachments do comando de envio.
A requisição inteira é limitada a 1 MB, e o base64 deixa o arquivo cerca de 33% maior, então este comando comporta arquivos de até uns 700 KB. Para arquivos maiores (até 25 MB), use Upload de arquivo grande, que recebe o arquivo como dados binários.
Limites: 20 arquivos e 25 MB por e-mail; por caixa de correio, 50 e-mails com uploads ainda não enviados e 500 MB no total. Uploads não enviados em 48 horas, e não usados por um rascunho ou e-mail agendado, são excluídos.
Argumentos
file_namestringobrigatórioNome do arquivo exibido para o destinatário.
contentstringobrigatórioO arquivo em base64 (uma URL data: também é aceita). A requisição é limitada a 1 MB, então cerca de 700 KB de arquivo.
content_typestringopcionalTipo MIME. O padrão é
application/octet-stream.compose_uidstringopcionalAdiciona o arquivo a um e-mail que você já está montando.
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "upload_attachment",
args: {
file_name: "invoice.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Resposta
{
"type": "SUCCESS",
"results": [
{
"command": "upload_attachment",
"id": "0",
"type": "SUCCESS",
"data": {
"compose_uid": "Vj0xQ01QMDAx",
"attachment": {
"id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
"file_name": "invoice.pdf",
"size_bytes": 48213,
"content_type": "application/pdf"
}
}
}
]
}Campos da resposta
compose_uidEnvie-o com os próximos uploads e com o comando de envio.
attachment.idUse-o em
attachment_idsoudelete_attachment.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
TOKEN_EXPIREDO access token expirou. Chame Refresh Token e repita a requisição.
- 401
INVALID_TOKENO token está malformado, é desconhecido ou foi revogado.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.
- CMD
INVALID_ARGSUm argumento obrigatório está ausente ou é inválido.
- CMD
INVALID_ATTACHMENTO conteúdo de um anexo não é base64 válido.
- CMD
ATTACHMENTS_TOO_LARGEOs anexos do e-mail somam mais de 25 MB, ou a caixa de correio já tem 500 MB de uploads aguardando envio.
- CMD
TOO_MANY_OPEN_COMPOSESA caixa de correio tem 50 e-mails com uploads ainda não enviados. Envie-os ou espere os não usados serem excluídos após 48 horas.
- CMD
FILE_BLOCKEDUm arquivo foi bloqueado pela verificação de segurança.
- CMD
ALREADY_SENTO compose_uid pertence a um e-mail que já foi enviado.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.