API-Changelog

v1-Update - Juli 2026

Additive Ergänzungen von Fehlercodes und Antwortfeldern zum bestehenden v1-Vertrag.

• Neuer Fehler 422 withdrawal_consent_required am Download-URLs-Endpunkt für Bestellungen: Er wird zurückgegeben, wenn der Shop die EU-Widerrufseinwilligung aktiviert hat und für die Bestellung noch keine Einwilligung erfasst ist; Download-URLs werden ausgestellt, sobald der Kunde einwilligt.
• Neuer Fehler 422 key_limit_reached beim Erstellen von API-Schlüsseln: Ein Shop kann höchstens 25 aktive API-Schlüssel halten; widerrufen Sie zuerst einen.
• Neuer Fehler 409 delivery_not_yet_released an den Endpunkten download-urls und resend für Bestellungen: Er wird zurückgegeben, wenn für das Produkt eine Verzögerung der Download-Zustellung konfiguriert ist und die Dateien des Käufers noch nicht freigeschaltet sind. Bis die Verzögerung abgelaufen ist, werden keine Download-URLs ausgestellt und keine E-Mail versendet.
• Neues Objekt error.details im Fehlerumschlag: Es ist nur bei Codes vorhanden, die für den Aufrufer unbedenklichen Kontext mitliefern. Derzeit ist delivery_not_yet_released der einzige Erzeuger; er enthält release_at, den ISO-8601-Zeitpunkt, zu dem die Downloads freigeschaltet werden. Behandeln Sie das Objekt als offen - neue Schlüssel können ohne Wechsel der Hauptversion hinzukommen.
• Neue Felder delivery_pending und release_at im Kaufobjekt des Bestellstatus: delivery_pending ist true, solange ein Kauf noch durch eine Verzögerung der Download-Zustellung zurückgehalten wird, und release_at ist der ISO-8601-Zeitpunkt der Freischaltung bzw. null, wenn nichts aussteht.
• Der Endpunkt grant-downloads gibt zurückgehaltene Käufe einer Bestellung jetzt sofort frei, sodass Händler eine Verzögerung der Download-Zustellung über die API übersteuern können.

v1.0.0 - Juni 2026

Erste Pilot-API-Oberfläche mit zugangsbeschränktem Zugriff (nur nach Freigabe).

• API-Schlüssel für freigegebene Shops.
• Erforderliche Idempotenz-Schlüssel bei Schreibanfragen.
• Asset-Import per Remote-URL, Direkt-Uploads, Asset-Auflistung, Asset-Aktualisierungen und Asset-Löschung.
• Flache Kategorien, Produktzuordnungen, Pakete und Lizenzschlüssel-Tags.
• Bestellzuweisungen, die zugeordnete Downloads in Shopify-Kundenkonten sichtbar machen.
• Zugriffssteuerung für Bestellungen: Widerruf, Wiederherstellung, Download-Freigabe und erneuter E-Mail-Versand.
• Endpunkte für Job- und Bestellstatus.
• Downloads der OpenAPI-Spezifikation und der Postman-Collection.

Versionierungsrichtlinie

Der v1-Vertrag ist rein additiv: Neue Endpunkte, optionale Felder und neue Fehlercodes können hinzugefügt werden. Breaking Changes werden einen künftigen /api/v2-Pfad verwenden.