# Testordner

> Einen DDEX-Batch vor der Auslieferung testen: der SFTP-Ordner /test und POST /ddex/validate. Dabei wird nichts angelegt.

<!-- Generated from openapi/hills-v1.json by scripts/api-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

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](https://developer.hillsmusic.com/de/reference/ddex-deliveries/#test-a-ddex-message-or-batch). 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.

<a id="over-sftp"></a>

## 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.

<a id="over-the-api"></a>

## 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).

<a id="test-reports"></a>

## 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`.

Quelle: https://developer.hillsmusic.com/de/reference/test-folder/