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

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

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

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

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

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

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

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

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

Nguồn: https://developer.hillsmusic.com/vi/reference/test-folder/