Preflight QC

Preflight QC adalah pengaya premium yang memberi Anda QC rilis profesional. Kirim sebuah rilis dan Preflight QC menganalisisnya dari awal sampai akhir: metadata, tanggal rilis, audio, artwork, dan dokumentasi lisensi. Anda menerima laporan kualitas yang jelas dan dapat ditindaklanjuti. Perbaiki apa yang ditandainya sesuai ritme Anda sendiri, lalu konfirmasikan rilis ke tinjauan saat Anda puas.

Bagi label dan integrator API, Preflight QC berfungsi sebagai balok penyusun. Ambil laporan kualitas secara terprogram, sambungkan ke pipeline QA Anda sendiri, jadikan dasar proses persetujuan internal Anda, dan konfirmasikan rilis ke tinjauan secara otomatis. Tim Anda yang menetapkan standar kualitas, Preflight QC yang melakukan analisisnya.

Rilis yang tiba dalam keadaan bersih melewati tinjauan dengan cepat. Preflight QC membawa Anda ke sana sebelum Anda mengirim.

Apa itu Preflight QC

Dengan Preflight QC diaktifkan pada akun Anda, rilis yang dikirim untuk distribusi tidak langsung masuk ke antrean tinjauan. Sebagai gantinya, rilis masuk ke penahanan pra-tinjauan (“menunggu peninjauan Anda”) selagi Preflight QC menjalankan analisis kualitasnya: metadata, tanggal rilis, audio, artwork, dan dokumentasi lisensi. Hasilnya adalah laporan kualitas, dan apa yang Anda bangun di atasnya terserah Anda:

• Alur kerja QA Anda sendiri (API). Jalankan katalog Anda melalui analisis kualitas, ambil laporannya secara terprogram di pipeline QA Anda sendiri, jadikan hasilnya dasar proses persetujuan internal Anda, dan konfirmasikan setiap rilis ke tinjauan hanya setelah lolos standar Anda. Lihat Menggunakan API untuk integrasi.
• Alur di aplikasi. Baca laporan di halaman rilis, perbaiki apa yang ditandainya, dan konfirmasi saat Anda puas.

Bagaimanapun caranya, konfirmasilah yang memindahkan rilis ke antrean tinjauan normal: tidak ada yang masuk tinjauan sebelum Anda memberi persetujuan.

Preflight QC menambahkan tahap kualitas sebelum tinjauan. Ia tidak mengubah apa yang terjadi setelahnya: begitu Anda mengonfirmasi, rilis Anda melalui proses validasi dan tinjauan yang sama seperti rilis lainnya.

Cara mendapatkan Preflight QC

Preflight QC adalah pengaya premium yang diaktifkan per akun oleh tim kami. Untuk mengaktifkannya pada akun Anda, hubungi tim penjualan kami dan beri tahu bahwa Anda menginginkan Preflight QC.

Setelah diaktifkan, Anda akan melihat langkah penahanan dan konfirmasi yang baru saat berikutnya Anda mengirim rilis untuk distribusi.

Alur kerja Preflight QC

Berikut perjalanan lengkap sebuah rilis dengan Preflight QC diaktifkan, dari pengiriman hingga tinjauan.

1. Kirim rilis Anda untuk distribusi

Buat dan lengkapi rilis Anda seperti biasa, lalu kirim untuk distribusi. Dengan Preflight QC diaktifkan, ini tidak langsung menempatkan rilis ke antrean tinjauan. Sebaliknya, rilis berpindah ke penahanan pra-tinjauan dan ditandai sebagai menunggu peninjauan Anda.

2. Analisis kualitas berjalan

Selagi rilis Anda ditahan, Preflight QC menganalisisnya dari awal sampai akhir. Analisisnya mencakup:

• Metadata: judul, artis, kredit, serta detail rilis dan trek lainnya
• Tanggal rilis: pengaturan tanggal dan versi rilis Anda
• Audio: berkas audio yang Anda unggah
• Artwork: gambar sampul Anda
• Lisensi: ketika sebuah cover, sampel (sample), atau yang serupa memerlukan dokumen pendukung

Analisis biasanya selesai beberapa menit setelah unggahan dan transcoding rampung. Selama masih berjalan, laporan kualitas menunjukkan bahwa pemeriksaan sedang berlangsung dan belum mencantumkan masalah apa pun.

3. Baca laporan kualitas Anda

Setelah analisis selesai, buka laporan kualitas rilis untuk melihat apa, jika ada, yang memerlukan perhatian Anda. Anda dapat membacanya di dua tempat:

• Melalui API publik, untuk pipeline QA Anda sendiri; lihat Menggunakan API di bawah.
• Di dalam aplikasi, pada halaman rilis.

Laporan mencantumkan setiap masalah dengan judul yang jelas dan pesan yang menjelaskan apa yang harus diperbaiki. Lihat Memahami laporan kualitas untuk cara membaca kolom-kolomnya.

4. Perbaiki apa yang ditandai

Telusuri masalah pada laporan Anda:

• Masalah metadata: sunting detail rilis atau trek.
• Masalah audio atau artwork: ganti berkas yang terpengaruh.
• Masalah yang meminta umpan balik: balas di utas catatan pada masalah tersebut, atau unggah dokumen yang diminta (misalnya, lisensi untuk sebuah cover atau sampel).

Menyunting rilis Anda selagi ditahan akan menjalankan ulang bagian analisis yang relevan, dan laporan diperbarui dengan hasil yang baru. Anda dapat mengulangi siklus ini sebanyak yang Anda perlukan.

5. Konfirmasi rilis

Ketika laporan Anda bersih, atau Anda telah menangani semua yang perlu, konfirmasi rilis. Di aplikasi, ini adalah tombol konfirmasi pada rilis; untuk integrasi, ini adalah endpoint konfirmasi.

Konfirmasi mengeluarkan rilis dari penahanan dan memindahkannya ke antrean tinjauan normal. Konfirmasi mengharuskan analisis selesai: jika Anda menyunting rilis setelah proses terakhir, tunggu laporan yang diperbarui sebelum mengonfirmasi.

6. Tinjauan normal

Setelah konfirmasi, rilis Anda ditinjau persis seperti rilis lainnya. Untuk apa yang terjadi selama tinjauan, lama waktunya, dan hasil yang mungkin, lihat Validasi dan tinjauan.

Memahami laporan kualitas

Laporan kualitas memiliki dua bagian: sebuah daftar masalah dan sebuah blok kecil detail laporan tentang proses analisis itu sendiri.

Masalah

Setiap masalah dalam laporan menjelaskan satu hal untuk dicermati. Kolom-kolom yang akan Anda kerjakan:

Kolom	Apa yang diberitahukannya
Judul	Nama singkat dan mudah dipahami untuk masalah tersebut.
Pesan	Apa masalahnya dan apa yang harus dilakukan.
Tingkat keparahan	Seberapa penting masalah itu, untuk membantu Anda menetapkan prioritas.
Memblokir	Apakah masalah harus diselesaikan sebelum Anda dapat mengonfirmasi (lihat di bawah).
Memerlukan umpan balik	Apakah masalah membutuhkan jawaban tertulis atau dokumen yang Anda unggah.
Deskripsi khusus	Detail tambahan yang spesifik untuk rilis Anda, jika tersedia.
Trek yang terpengaruh	Trek mana yang terkena masalah. Masalah tingkat rilis tidak mencantumkan trek tertentu.

Memblokir atau informatif

• Masalah yang memblokir harus diselesaikan sebelum Anda dapat mengonfirmasi rilis untuk tinjauan. Perbaiki apa yang dijelaskannya, biarkan analisis berjalan ulang, dan masalah akan hilang dari laporan Anda.
• Masalah informatif ada untuk menandai sesuatu yang layak dilihat, tetapi tidak menghentikan Anda untuk mengonfirmasi. Cermati, lalu konfirmasi saat Anda siap.

Masalah yang memerlukan umpan balik

Sebagian masalah tidak dapat diselesaikan hanya dengan menyunting: masalah itu memerlukan sesuatu dari Anda, seperti penjelasan tertulis atau dokumen pendukung (misalnya, lisensi untuk sebuah cover atau sampel). Masalah ini ditandai sebagai memerlukan umpan balik. Untuk menyelesaikannya, balas di utas catatan pada masalah tersebut atau unggah dokumen yang diminta sebelum mengonfirmasi.

Detail laporan

Di samping masalah, laporan menyertakan beberapa detail tentang proses analisis:

Kolom	Apa yang diberitahukannya
generated_at	Kapan laporan saat ini dihasilkan. Kosong selama analisis pertama masih berjalan.
checks_in_progress	true selama analisis masih berjalan; daftar masalah akan kosong hingga analisis selesai.
hold	Apakah rilis saat ini berada dalam penahanan pra-tinjauan.
review_status	Status tinjauan rilis saat ini.
profile	Profil kualitas yang diterapkan pada rilis ini.

Menggunakan API untuk integrasi

Jika Anda membangun di atas API publik LabelGrid, Anda dapat menyambungkan Preflight QC ke pipeline Anda sendiri: jalankan setiap rilis melalui analisis kualitas, ambil laporannya ke alur kerja QA Anda sendiri, jadikan dasar proses persetujuan internal Anda, dan konfirmasikan ke tinjauan dari perangkat Anda sendiri. Preflight QC menyediakan dua endpoint untuk ini; keduanya menggunakan autentikasi token Bearer yang sama seperti bagian lain dari API publik. Untuk skema permintaan dan respons yang lengkap dan selalu terkini, lihat referensi API.

Mengambil laporan kualitas

GET /v4/public/rilis/{id}/quality-report
Authorization: Bearer YOUR_API_TOKEN

Mengembalikan laporan kualitas rilis saat ini. Respons memuat:

• issues[]: satu entri per masalah, masing-masing dengan code (string yang stabil; lihat Bekerja dengan kode masalah), title, message, severity, is_blocking, requires_feedback, custom_description, dan affected_tracks.
• report: generated_at, checks_in_progress, hold, review_status, dan profile.

Selama analisis masih berjalan, laporan mengembalikan checks_in_progress: true dengan daftar issues yang kosong. Lakukan polling pada endpoint hingga generated_at terisi, biasanya beberapa menit setelah unggahan dan transcoding selesai, lalu baca masalahnya.

Contoh respons setelah analisis selesai:

{
  "issues": [
    {
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "hold": true,
    "review_status": "…",
    "profile": "…"
  }
}

Mengonfirmasi rilis untuk tinjauan

POST /v4/public/rilis/{id}/confirm-review
Authorization: Bearer YOUR_API_TOKEN

Mengeluarkan rilis dari penahanan dan memindahkannya ke antrean tinjauan normal: padanan tombol konfirmasi di aplikasi versi API.

Konfirmasi mengharuskan analisis selesai. Jika rilis disunting setelah proses analisis terakhir, laporan sedang dibuat ulang, dan endpoint mengembalikan sebuah konflik. Ketika itu terjadi, ambil kembali laporan kualitas, tunggu hingga generated_at terisi lagi, lalu coba konfirmasi ulang.

Bekerja dengan kode masalah

Jika Anda membangun logika di atas laporan kualitas, dasarkan pada code masalah:

• code adalah string yang stabil dalam format slug (misalnya audio.trailing-silence). Aman untuk memetakan kode di sistem Anda dan membangun logika di atasnya.
• Judul dan pesan adalah teks untuk manusia. Keduanya dapat diperhalus seiring waktu, jadi jangan pernah mendasarkan logika pada teks; gunakan hanya untuk tampilan.
• Kode baru dapat muncul seiring cakupan Preflight QC berkembang. Tangani kode yang tidak Anda kenali secara generik: tampilkan title dan message dari respons alih-alih gagal.
• Laporan Anda mengajarkan kode yang penting. Seiring Anda menjalankan rilis melalui Preflight QC, kode yang relevan dengan katalog Anda muncul secara alami di laporan kualitas Anda sendiri.
• Apa yang dicakup analisis. Masalah terbagi dalam kategori berikut: metadata rilis dan trek, tanggal dan versi rilis, kualitas audio, artwork, serta lisensi dan dokumentasi.

Katalog masalah

Untuk memetakan masalah saat membangun alur kerja QA Anda sendiri, ambil katalog lengkapnya secara terprogram:

GET /v4/public/issue-definitions
Authorization: Bearer YOUR_API_TOKEN

Endpoint ini mengembalikan setiap masalah yang dapat muncul dalam laporan kualitas, dengan kode string yang stabil sebagai kuncinya, beserta judul, templat pesan, tingkat keparahan, penanda pemblokiran, dan requires_feedback. Endpoint ini hanya tersedia untuk akun dengan pengaya Preflight QC.

Pertanyaan yang sering diajukan

Bagaimana jika analisis masih berjalan?

Laporan akan menampilkan checks_in_progress: true tanpa masalah yang tercantum untuk saat ini. Ini normal tepat setelah Anda mengirim. Tunggu beberapa menit setelah unggahan dan transcoding selesai, lalu periksa lagi: di aplikasi laporan akan menyegarkan dirinya sendiri, dan melalui API Anda dapat melakukan polling hingga generated_at terisi.

Bisakah saya menyunting rilis selagi ditahan?

Bisa. Menyunting rilis dalam penahanan pra-tinjauan akan menjalankan ulang bagian analisis yang relevan dan memperbarui laporan, jadi Anda dapat memperbaiki masalah dan melihat hasil yang diperbarui tanpa keluar dari penahanan. Ingat saja bahwa setelah menyunting, Anda perlu menunggu laporan yang diperbarui sebelum dapat mengonfirmasi.

Apa yang terjadi setelah saya mengonfirmasi?

Rilis Anda keluar dari penahanan dan bergabung ke antrean tinjauan normal, tempat ia ditinjau seperti rilis lainnya. Lihat Validasi dan tinjauan untuk cara kerja tinjauan, lama waktunya, dan hasil yang mungkin.

Bisakah saya mengembalikan rilis ke draf?

Bisa: selama rilis Anda berada dalam penahanan pra-tinjauan dan Anda belum mengonfirmasinya, rilis belum masuk tinjauan, sehingga Anda bebas untuk terus menyuntingnya atau membiarkannya sebagai draf dan kembali nanti. Rilis baru masuk ke antrean tinjauan ketika Anda mengonfirmasinya.

Apakah saya harus memperbaiki setiap masalah sebelum mengonfirmasi?

Anda harus menyelesaikan masalah yang memblokir sebelum dapat mengonfirmasi. Masalah informatif tidak menghentikan Anda untuk mengonfirmasi, tetapi layak dilihat: membereskan sebanyak mungkin sebelum tinjauan adalah jalur tercepat menuju persetujuan.

---

Ada pertanyaan tentang Preflight QC? Hubungi tim kami. Kami dengan senang hati membantu.