Thư mục test
Kiểm thử một lô DDEX trước khi phân phối: thư mục SFTP /test và POST /ddex/validate. Không có gì được tạo ra.
Mỗi hộp thư DDEX là một tài khoản đăng nhập SFTP với đúng hai thư mục: /test kiểm tra một lô mà không tạo gì, /production nhập lô đó. API chỉ có một loại key (hm_live_…); đường kiểm thử của API là POST /ddex/validate. Một lần kiểm thử chạy mọi bước kiểm tra như một lần phân phối thật (XML, các quy tắc của HILLS, tệp audio, ảnh bìa và video, UPC và ISRC so với danh mục, thể loại, vùng lãnh thổ và điều khoản phát hành) và giữ nguyên danh mục: không bản phát hành, bản ghi âm, nghệ sĩ, mã hay lần phân phối nào được tạo.
Qua SFTP
Mỗi tài khoản có một thông tin đăng nhập, được tạo cùng hộp thư. Tải lên /production/<batch>/ để phân phối, hoặc /test/<batch>/ để kiểm thử; một lô là một thư mục chứa XML ERN (khuyến nghị 4.3.2 hoặc 3.8.2) và các tệp mà nó tham chiếu, kết thúc bằng tệp đánh dấu (BatchComplete_*.xml hoặc bất kỳ *.complete nào).
| Đường dẫn | Điều gì xảy ra |
|---|---|
/production/<batch>/ |
Khi tệp đánh dấu đến nơi, lô được nhập: mỗi bản phát hành trở thành một bản nháp trong danh mục của bạn rồi đi qua kiểm duyệt và phân phối đến các nền tảng như thường lệ. Mỗi lô nằm trong thư mục riêng. |
/test/<batch>/ |
Khi tệp đánh dấu đến nơi, lô được đọc và kiểm tra đầy đủ. Không có gì được tạo ra. Báo cáo được ghi ngay cạnh lô: /test/<batch>.report.txt và /test/<batch>.report.json. |
/test/<file>.xml hoặc /test/<file>.zip |
Một message hoặc tệp zip đơn lẻ, được kiểm thử theo cùng cách; báo cáo nằm tại /test/<file>.report.txt và .report.json. |
Mọi tệp khác trong /test/ |
Một lần kiểm tra kết nối (ping.txt là đủ): trang DDEX trong dashboard hiển thị kết nối đang hoạt động. |
Thư mục lô production không bao giờ nhận được tệp đánh dấu sẽ bị xóa sau 7 ngày; mọi thứ nằm trong /test (lô, báo cáo, tệp kiểm tra kết nối) cũng bị xóa sau cùng khoảng thời gian đó.
Qua API
Production
Dữ liệu thật. POST /ddex (và tải lên trực tiếp) phân phối các lô DDEX, chúng trở thành bản phát hành nháp trong danh mục của bạn rồi đi qua kiểm duyệt và phân phối đến các nền tảng như thường lệ. SFTP: thư mục /production.
Test
Cùng một key. POST /ddex/validate nhận một tệp .xml hoặc .zip và chạy mọi bước kiểm tra như một lần phân phối (XML, các quy tắc của HILLS, tệp audio, ảnh bìa và video, UPC và ISRC so với danh mục, thể loại, vùng lãnh thổ và điều khoản phát hành), rồi trả về báo cáo. Không có gì được tạo ra: không bản phát hành, bản ghi âm, nghệ sĩ, mã hay lần phân phối nào. SFTP: thư mục /test (báo cáo được ghi cạnh mỗi lô). Trang DDEX trong dashboard liệt kê mọi lần kiểm thử trong mục Test reports. Key test (hm_test_…) đã ngừng sử dụng từ 12/10/2026 và bị từ chối (401 test_keys_retired).
Báo cáo kiểm thử
Mọi lần kiểm thử, từ SFTP, API hay dashboard, đều được liệt kê trên trang DDEX trong dashboard, mục Test reports, và được lưu 90 ngày: mọi bước kiểm tra theo giai đoạn (pass / warning / error / skipped), những gì HILLS sẽ tạo, và kết luận: would_import, would_import_with_warnings, would_be_flagged hoặc would_be_rejected.