E-Mails empfangen: Anhänge

Große Datei hochladen

Laden Sie eine Datei bis 25 MB als Binärdaten hoch, außerhalb des 1-MB-JSON von POST /v1. Liefert dieselbe compose_uid und Anhang-ID wie upload_attachment.

POSThttps://g.sendcorex.com/v1/attachment
i

Verwenden Sie diese Route für Dateien über etwa 700 KB. Bei upload_attachment steckt die Datei als Base64 im JSON, das auf 1 MB begrenzt ist, und Base64 macht die Datei etwa 33 % größer.

i

Senden Sie dann die compose_uid (und optional attachment_ids) in send_email, reply, forward, schedule_send oder save_draft. Senden Sie dieselbe compose_uid erneut, um derselben E-Mail weitere Dateien hinzuzufügen.

!

Uploads, die nicht innerhalb von 48 Stunden gesendet werden und von keinem Entwurf und keiner geplanten E-Mail verwendet werden, werden gelöscht. Laden Sie die Datei erneut hoch, wenn Sie ATTACHMENT_MISSING erhalten.

Query-Parameter

  • file_namestringerforderlich

    Dateiname, der dem Empfänger angezeigt wird. Erforderlich bei binärem Body; bei Multipart wird der Name des file-Teils verwendet.

  • compose_uidstringoptional

    Fügt die Datei einer E-Mail hinzu, die Sie bereits zusammenstellen. Bei Multipart kann es auch ein Formularfeld sein.

Schnellstart

import axios from 'axios';
import { readFileSync } from 'node:fs';

const res = await axios.post('https://g.sendcorex.com/v1/attachment', readFileSync('invoice.pdf'), {
  params: { file_name: 'invoice.pdf' },
  headers: {
    Authorization: process.env.SENDCOREX_TOKEN,
    'Content-Type': 'application/pdf',
  },
  maxBodyLength: Infinity,
});

const { compose_uid, attachment } = res.data.data;
console.log(compose_uid, attachment.id);

Antwort

{
  "type": "SUCCESS",
  "data": {
    "compose_uid": "Vj0xQ01QMDAx",
    "attachment": {
      "id": "6f1c2a9e-4b7d-4e21-9a3f-0c8d5e7b1a42",
      "file_name": "invoice.pdf",
      "size_bytes": 3145728,
      "content_type": "application/pdf"
    }
  }
}

Antwortfelder

  • data.compose_uid

    Senden Sie sie mit den nächsten Uploads derselben E-Mail und mit dem Sendebefehl.

  • data.attachment.id

    Verwenden Sie sie in attachment_ids oder delete_attachment.

Request-Body

Senden Sie die Datei auf eine von zwei Arten. Eine Datei pro Anfrage.

  • Binär

    Der Body ist die Datei selbst. Setzen Sie Content-Type auf den Dateityp (zum Beispiel application/pdf); ohne ihn wird die Datei als application/octet-stream gespeichert.

  • Multipart

    multipart/form-data mit der Datei im Feld file. Optionale Felder: compose_uid und file_name.

Limits

  • Pro Datei

    25 MB.

  • Pro E-Mail

    20 Dateien und insgesamt 25 MB.

  • Pro Postfach

    50 E-Mails mit noch nicht gesendeten Uploads und insgesamt 500 MB. Das Senden einer E-Mail gibt ihren Anteil sofort frei.

  • Ungenutzte Uploads

    Werden nach 48 Stunden gelöscht, wenn kein Entwurf und keine geplante E-Mail sie verwendet. Dateien eines Entwurfs oder einer geplanten E-Mail bleiben, solange diese existiert.

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.

  • 400INVALID_ARGS

    `file_name` fehlt (binärer Body), das Multipart hat kein `file`-Feld oder mehr als eines, oder `compose_uid` ist ungültig.

  • 400INVALID_ATTACHMENT

    Die Datei ist leer oder konnte nicht gelesen werden.

  • 400FILE_BLOCKED

    Die Datei wurde von der Sicherheitsprüfung blockiert.

  • 400ALREADY_SENT

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

  • 400TOO_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.

  • 413ATTACHMENTS_TOO_LARGE

    Die Datei ist größer als 25 MB, die E-Mail überschreitet 25 MB, oder das Postfach hat bereits 500 MB an Uploads, die auf den Versand warten.

  • CMDINTERNAL

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