Testordner
Einen DDEX-Batch vor der Auslieferung testen: der SFTP-Ordner /test und POST /ddex/validate. Dabei wird nichts angelegt.
Jede DDEX-Inbox ist ein SFTP-Login mit genau zwei Ordnern: /test prüft einen Batch und legt nichts an, /production importiert ihn. Die API kennt nur eine Art von Schlüssel (hm_live_…); ihr Testweg ist POST /ddex/validate. Ein Test durchläuft jede Prüfung, die auch eine Auslieferung durchläuft (XML, die HILLS-Regeln, Audio-, Artwork- und Videodateien, UPCs und ISRCs im Abgleich mit dem Katalog, Genres, Territorien und Deals), und lässt den Katalog unverändert: kein Release, keine Aufnahme, kein Artist, kein Code und keine Auslieferung.
Per SFTP
Ein Login pro Konto, eingerichtet mit der Inbox. Laden Sie in /production/<batch>/ hoch, um zu liefern, oder in /test/<batch>/, um zu testen. Ein Batch ist ein Ordner mit dem ERN-XML (empfohlen: 4.3) und den Dateien, auf die es verweist, abgeschlossen durch seine Markerdatei (BatchComplete_*.xml oder eine beliebige *.complete).
| Pfad | Was passiert |
|---|---|
/production/<batch>/ |
Sobald die Markerdatei eintrifft, wird der Batch importiert: Jedes Release wird ein Entwurf in Ihrem Katalog und durchläuft wie gewohnt Prüfung und Auslieferung an die Stores. Jeder Batch in einem eigenen Ordner. |
/test/<batch>/ |
Sobald die Markerdatei eintrifft, wird der Batch gelesen und vollständig geprüft. Es wird nichts angelegt. Der Bericht wird daneben abgelegt: /test/<batch>.report.txt und /test/<batch>.report.json. |
/test/<file>.xml oder /test/<file>.zip |
Eine einzelne Nachricht oder ZIP-Datei, auf dieselbe Weise getestet; der Bericht landet unter /test/<file>.report.txt und .report.json. |
/test/<anything else> |
Ein Verbindungstest (ping.txt genügt): Die DDEX-Seite im Dashboard zeigt die Verbindung dann als funktionsfähig an. |
Ein Produktions-Batch-Ordner, der nie seine Markerdatei erhält, wird nach 7 Tagen entfernt; alles, was in /test liegt (Batches, Berichte, Dateien für Verbindungstests), nach derselben Frist.
Per API
Production
Echte Daten. POST /ddex (und Direkt-Uploads) liefern DDEX-Batches, die als Release-Entwürfe in Ihrem Katalog landen und wie gewohnt Prüfung und Auslieferung an die Stores durchlaufen. SFTP: der Ordner /production.
Test
Derselbe Schlüssel. POST /ddex/validate nimmt eine .xml oder eine .zip entgegen, durchläuft jede Prüfung, die auch eine Auslieferung durchläuft (XML, die HILLS-Regeln, Audio-, Artwork- und Videodateien, UPCs und ISRCs im Abgleich mit dem Katalog, Genres, Territorien und Deals), und antwortet mit dem Bericht. Es wird nichts angelegt: kein Release, keine Aufnahme, kein Artist, kein Code und keine Auslieferung. SFTP: der Ordner /test (neben jedem Batch wird ein Bericht abgelegt). Die DDEX-Seite im Dashboard listet jeden Test unter Test reports auf. Testschlüssel (hm_test_…) wurden am 12. Oktober 2026 eingestellt und werden abgelehnt (401 test_keys_retired).
Testberichte
Jeder Test – ob per SFTP, API oder Dashboard – erscheint auf der DDEX-Seite im Dashboard unter „Test reports“ und bleibt 90 Tage erhalten: jede Prüfung nach Phase (pass / warning / error / skipped), was HILLS anlegen würde, und das Ergebnis: would_import, would_import_with_warnings, would_be_flagged oder would_be_rejected.