E-Mails empfangen: Anhänge

Anhang hochladen

Laden Sie eine Datei vor dem Senden hoch. Verwenden Sie die zurückgegebene compose_uid in send_email, reply, forward oder schedule_send.

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

Ohne compose_uid wird eine neue erstellt. Senden Sie sie mit den nächsten Dateien derselben E-Mail zurück. Jede Datei wird vor dem Speichern geprüft.

i

Für einzelne Dateien können Sie diesen Schritt auch überspringen und sie direkt in attachments des Sendebefehls mitschicken.

!

Die gesamte Anfrage ist auf 1 MB begrenzt, und Base64 macht die Datei etwa 33 % größer, daher passen mit diesem Befehl Dateien bis etwa 700 KB. Für größere Dateien (bis 25 MB) verwenden Sie Große Datei hochladen, das die Datei als Binärdaten entgegennimmt.

i

Limits: 20 Dateien und 25 MB pro E-Mail; pro Postfach 50 E-Mails mit noch nicht gesendeten Uploads und insgesamt 500 MB. Uploads, die nicht innerhalb von 48 Stunden gesendet und nicht von einem Entwurf oder einer geplanten E-Mail verwendet werden, werden gelöscht.

Argumente

  • file_namestringerforderlich

    Dateiname, der dem Empfänger angezeigt wird.

  • contentstringerforderlich

    Die Datei in Base64 (eine data:-URL wird ebenfalls akzeptiert). Die Anfrage ist auf 1 MB begrenzt, also etwa 700 KB Datei.

  • content_typestringoptional

    MIME-Typ. Standard ist application/octet-stream.

  • compose_uidstringoptional

    Fügt die Datei einer E-Mail hinzu, die Sie bereits zusammenstellen.

Schnellstart

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

Antwort

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

Antwortfelder

  • compose_uid

    Senden Sie sie mit den nächsten Uploads und mit dem Sendebefehl.

  • attachment.id

    Verwenden Sie sie in attachment_ids oder delete_attachment.

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 401TOKEN_EXPIRED

    Der Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

  • 429RATE_LIMITED

    Mehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDINVALID_ATTACHMENT

    Der Inhalt eines Anhangs ist kein gültiges Base64.

  • CMDATTACHMENTS_TOO_LARGE

    Die Anhänge der E-Mail ergeben zusammen mehr als 25 MB, oder das Postfach hat bereits 500 MB an Uploads, die auf den Versand warten.

  • CMDTOO_MANY_OPEN_COMPOSES

    Das Postfach hat 50 E-Mails mit noch nicht gesendeten Uploads. Senden Sie sie oder warten Sie, bis die ungenutzten nach 48 Stunden gelöscht werden.

  • CMDFILE_BLOCKED

    Eine Datei wurde von der Sicherheitsprüfung blockiert.

  • CMDALREADY_SENT

    Die compose_uid gehört zu einer E-Mail, die bereits gesendet wurde.

  • CMDINTERNAL

    Serverfehler. Die Details werden nur ins Server-Log geschrieben.