Zum Hauptinhalt springen
- Endpunkt-Referenz

API-Endpunkt-Referenz

Dies sind die kundengerichteten Endpunkte der ersten API-Version. Alle Pfade sind relativ zu Ihrer API-Basis-URL, die Ihnen die App unter Einstellungen → API keys anzeigt, sobald Sie einen Schlüssel erstellt haben.

Assets

MethodePfadZweck
POST/assetsEine Remote-URL als Asset importieren.
POST/assets/uploadsEinen Direkt-Upload starten.
POST/assets/uploads/{uploadId}/completeEinen Direkt-Upload abschließen.
GET/assetsAssets auflisten.
GET/PATCH/DELETE/assets/{id}Ein Asset lesen, aktualisieren oder löschen.

Kategorien, Zuordnungen, Pakete, Links und Tags

MethodePfadZweck
GET/POST/categoriesFlache Kategorien auflisten oder anlegen.
GET/PATCH/DELETE/categories/{id}Eine Kategorie lesen, umbenennen oder löschen.
GET/POST/mappingsShopify-Produktzuordnungen auflisten oder per Upsert anlegen.
GET/PUT/DELETE/mappings/{id}Eine Zuordnung lesen, ersetzen oder löschen.
GET/POST/packsPacks auflisten oder anlegen.
GET/DELETE/packs/{id}Ein Pack lesen oder löschen.
GET/POST/linksLinks auflisten oder anlegen. Das Anlegen erfordert einen kostenpflichtigen Plan; Besuchslimits und Ablauf bleiben dem Admin vorbehalten.
GET/POST/license-key-tagsLizenzschlüssel-Tags auflisten oder anlegen.

Bestellungen und Zugriff

MethodePfadZweck
GET/orders/{shopify_order_id}Den Download-Status einer Bestellung lesen.
GET/POST/orders/{shopify_order_id}/assignmentsZuweisungen auf Produktebene auflisten oder anlegen.
GET/orders/{shopify_order_id}/assignments/{purchaseId}/download-urlsDownload-URLs erzeugen.
POST/orders/{shopify_order_id}/revokeZugriff deaktivieren.
POST/orders/{shopify_order_id}/restoreZugriff wiederherstellen.
POST/orders/{shopify_order_id}/grant-downloadsZusätzliche Downloads gewähren.
POST/orders/{shopify_order_id}/resendDie Liefer-E-Mail erneut senden.

Der Download-URLs-Endpunkt gibt 422 withdrawal_consent_required zurück, 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.

Die Endpunkte download-urls und resend geben 409 delivery_not_yet_released zurück, wenn für das Produkt eine Verzögerung der Download-Zustellung konfiguriert ist und die Dateien des Käufers noch nicht freigeschaltet sind. Der Wert error.details.release_at ist der ISO-8601-Zeitpunkt der Freischaltung; der Endpunkt grant-downloads gibt die Bestellung vorzeitig frei.

Health und Status

MethodePfadZweck
GET/healthDie API-Verfügbarkeit prüfen.
GET/pingDie Authentifizierung prüfen.
GET/jobs/{jobId}Den Status eines asynchronen Jobs lesen.

API-Dokumentation

War das hilfreich?

Immer noch nicht weiter? Schreiben Sie an admin@alvaapps.com.

Zuletzt aktualisiert 2026-06-05