Menerima Email: Lampiran

Unggah lampiran

Unggah file sebelum mengirim. Gunakan compose_uid yang dikembalikan di send_email, reply, forward, atau schedule_send.

POSThttps://g.sendcorex.com/v1command: upload_attachment
i

Tanpa compose_uid, yang baru akan dibuat. Kirim kembali bersama file berikutnya untuk email yang sama. Setiap file dipindai sebelum disimpan.

i

Untuk file sekali pakai, Anda juga bisa melewati langkah ini dan mengirimnya langsung di attachments pada perintah kirim.

!

Seluruh request dibatasi 1 MB, dan base64 membuat file sekitar 33% lebih besar, jadi perintah ini muat file hingga sekitar 700 KB. Untuk file yang lebih besar (hingga 25 MB), gunakan Unggah file besar, yang menerima file sebagai data biner.

i

Batas: 20 file dan 25 MB per email; per kotak surat, 50 email dengan unggahan yang belum dikirim dan total 500 MB. Unggahan yang tidak dikirim dalam 48 jam, dan tidak dipakai oleh draf atau email terjadwal, akan dihapus.

Argumen

  • file_namestringwajib

    Nama file yang ditampilkan ke penerima.

  • contentstringwajib

    File dalam base64 (URL data: juga diterima). Request dibatasi 1 MB, jadi sekitar 700 KB file.

  • content_typestringopsional

    Tipe MIME. Default application/octet-stream.

  • compose_uidstringopsional

    Tambahkan file ke email yang sedang Anda susun.

Mulai cepat

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);

Respons

{
  "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"
        }
      }
    }
  ]
}

Field respons

  • compose_uid

    Kirim bersama unggahan berikutnya dan bersama perintah kirim.

  • attachment.id

    Gunakan di attachment_ids atau delete_attachment.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401TOKEN_EXPIRED

    Access token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.

  • 401INVALID_TOKEN

    Token salah format, tidak dikenal, atau dicabut.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • CMDINVALID_ARGS

    Argumen wajib tidak ada atau tidak valid.

  • CMDINVALID_ATTACHMENT

    Konten lampiran bukan base64 yang valid.

  • CMDATTACHMENTS_TOO_LARGE

    Lampiran email totalnya lebih dari 25 MB, atau kotak surat sudah memiliki 500 MB unggahan yang menunggu dikirim.

  • CMDTOO_MANY_OPEN_COMPOSES

    Kotak surat memiliki 50 email dengan unggahan yang belum dikirim. Kirim email tersebut, atau tunggu yang tidak terpakai dihapus setelah 48 jam.

  • CMDFILE_BLOCKED

    Sebuah file diblokir oleh pemindaian keamanan.

  • CMDALREADY_SENT

    compose_uid milik email yang sudah terkirim.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.