Was ist eine Payload?

Die Payload ist der Inhalt einer API-Anfrage oder -Antwort, der tatsächlich relevante Daten enthält, im Unterschied zu den technischen Metadaten (Headers, Statuscodes, Protokollinformationen). Bei einer Bestellübertragung ist die Payload der Teil mit Kundendaten, Artikeln, Mengen und Preisen. Alles andere ist Rahmendaten.

Der Begriff kommt aus der Technik und beschreibt ursprünglich den “nützlichen Teil” einer Lieferung, das heißt das, wofür man bezahlt, im Gegensatz zu Verpackung und Transportmitteln.

Wo begegnet dir die Payload konkret?

Bei einem HTTP POST-Request trägt der Request Body die Payload. Bei einem Webhook, der dein System über ein Ereignis benachrichtigt, enthält die Payload die Daten zu diesem Ereignis.

Ein einfaches Beispiel: Ein Webhook sendet bei einer neuen Shopify-Bestellung eine JSON-Payload mit folgendem Inhalt:

{
  "id": 450789469,
  "email": "kunde@example.com",
  "total_price": "129.90",
  "line_items": [
    {
      "product_id": 632910392,
      "quantity": 1,
      "price": "129.90"
    }
  ]
}

Das ist die Payload. Die HTTP-Headers außenrum (Content-Type, Timestamp, Signature) sind die Metadaten.

Payload-Größe und Limitierungen

APIs haben oft Limits für die maximale Payload-Größe. Typisch sind Limits zwischen 1 MB und 10 MB. Wenn du sehr große Datenmengen übertragen musst (Bildgalerie, Massenproduktimport), kann die Payload-Größe zum Problem werden.

Lösungsansätze: Pagination (Daten in mehreren kleinen Anfragen senden), Komprimierung (GZip-Komprimierung reduziert Payload-Größe deutlich), oder für Dateien den Upload über separate File-Endpoints mit Reference-ID in der Hauptpayload.

Payload-Validierung

Jede Payload, die dein System empfängt, sollte validiert werden, bevor du sie verarbeitest. Stimmt die erwartete Struktur? Sind Pflichtfelder vorhanden? Sind Datentypen korrekt? Eine nicht validierte Payload kann zu Verarbeitungsfehlern oder, wenn sie aus unsicherer Quelle stammt, zu Sicherheitsproblemen führen.

Bei der Automation und Softwareentwicklung dokumentieren wir Payload-Strukturen für jede Schnittstelle im Mapping-Dokument. Beim Termin können wir die Payloads deiner wichtigsten Schnittstellen durchgehen und schauen, wo noch Validierungslücken bestehen.