Preflight QC

Preflight QC, size profesyonel yayın kalite kontrolü sunan premium bir eklentidir. Bir yayın gönderin; Preflight QC onu baştan sona analiz eder: meta veriler, yayın tarihleri, ses, görsel ve lisans belgeleri. Net ve eyleme dönük bir kalite raporu alırsınız. İşaretlenenleri kendi hızınızda düzeltin, memnun kaldığınızda yayını incelemeye onaylayın.

Plak şirketleri ve API entegratörleri için Preflight QC bir yapı taşı olarak çalışır. Kalite raporunu programatik olarak çekin, kendi QA hattınıza bağlayın, iç onay sürecinizi buna dayandırın ve yayınları incelemeye otomatik olarak onaylayın. Kalite çıtasını ekibiniz belirler, analizi Preflight QC yapar.

Temiz gelen bir yayın incelemeden hızla geçer. Preflight QC sizi daha göndermeden o noktaya getirir.

Preflight QC nedir

Hesabınızda Preflight QC etkinken, dağıtım için gönderilen bir yayın doğrudan inceleme kuyruğuna girmez. Bunun yerine yayın, Preflight QC kalite analizini çalıştırırken bir inceleme öncesi bekletmeye (“sizin gözden geçirmeniz bekleniyor”) alınır. Analiz meta verileri, yayın tarihlerini, sesi, görseli ve lisans belgelerini kapsar. Sonuç bir kalite raporudur ve üzerine ne kuracağınız size kalmış:

• Kendi QA iş akışınız (API). Kataloğunuzu kalite analizinden geçirin, raporu programatik olarak kendi QA hattınıza çekin, iç onay sürecinizi sonuçlara bağlayın ve her yayını yalnızca kendi çıtanızı aştığında incelemeye onaylayın. Bkz. Entegrasyonlar için API’yi kullanma.
• Uygulamadaki akış. Raporu yayın sayfasında okuyun, işaretlenenleri düzeltin ve memnun kaldığınızda onaylayın.

Her iki durumda da yayını normal inceleme kuyruğuna taşıyan şey onaydır: siz onay vermeden hiçbir şey incelemeye girmez.

Preflight QC, incelemeden önce bir kalite aşaması ekler. İnceleme sonrasında olanları değiştirmez: onayladığınız anda yayınınız, diğer tüm yayınlarla aynı doğrulama ve inceleme sürecinden geçer.

Preflight QC’yi nasıl edinirsiniz

Preflight QC, ekibimizin hesap bazında etkinleştirdiği premium bir eklentidir. Hesabınızda açmak için satış ekibimizle iletişime geçin ve Preflight QC istediğinizi belirtin.

Etkinleştirildikten sonra, bir yayını dağıtım için bir sonraki gönderişinizde yeni bekletme ve onaylama adımını göreceksiniz.

Preflight QC iş akışı

Preflight QC etkinleştirilmiş bir yayının, gönderimden incelemeye kadarki tam yolu şöyledir.

1. Yayınınızı dağıtım için gönderin

Yayınınızı her zamanki gibi oluşturup tamamlayın, ardından dağıtım için gönderin. Preflight QC etkinken bu, yayını hemen inceleme kuyruğuna koymaz. Bunun yerine yayın bir inceleme öncesi bekletmeye geçer ve sizin gözden geçirmeniz bekleniyor olarak işaretlenir.

2. Kalite analizi çalışır

Yayınınız bekletmedeyken Preflight QC onu baştan sona analiz eder. Analiz şunları kapsar:

• Meta veriler: başlıklar, sanatçılar, katkı bilgileri ve diğer yayın ve parça ayrıntıları
• Yayın tarihleri: tarih ayarlarınız ve yayın sürümleri
• Ses: yüklediğiniz ses dosyaları
• Görsel: kapak görseliniz
• Lisanslar: bir cover, örnekleme (sample) veya benzeri bir öğe destekleyici belge gerektirdiğinde

Analiz genellikle yükleme ve dönüştürme (transcoding) tamamlandıktan birkaç dakika sonra biter. Hâlâ çalışırken, kalite raporu kontrollerin devam ettiğini belirtir ve henüz hiçbir sorunu listelemez.

3. Kalite raporunuzu okuyun

Analiz bittiğinde, dikkatinizi gerektiren bir şey varsa görmek için yayının kalite raporunu açın. Raporu iki yerde okuyabilirsiniz:

• Herkese açık API üzerinden, kendi QA hattınız için; aşağıdaki API’yi kullanma bölümüne bakın.
• Uygulama içinde, yayın sayfasında.

Rapor her sorunu net bir başlıkla ve neyin düzeltileceğini açıklayan bir mesajla listeler. Alanları nasıl okuyacağınız için Kalite raporunu anlama bölümüne bakın.

4. İşaretlenenleri düzeltin

Raporunuzdaki sorunları tek tek ele alın:

• Meta veri sorunları: yayının veya parçanın ayrıntılarını düzenleyin.
• Ses veya görsel sorunları: ilgili dosyayı değiştirin.
• Geri bildirim isteyen sorunlar: sorunun not dizisinde yanıt verin veya istenen belgeyi yükleyin (örneğin bir cover veya örnekleme için lisans).

Yayınınızı bekletmedeyken düzenlemek analizin ilgili bölümlerini yeniden çalıştırır ve rapor yeni sonuçlarla güncellenir. Bu döngüyü ihtiyaç duyduğunuz kadar tekrarlayabilirsiniz.

5. Yayını onaylayın

Raporunuz temiz olduğunda, ya da ele almanız gereken her şeyi hallettiğinizde, yayını onaylayın. Uygulamada bu, yayının üzerindeki bir onaylama düğmesidir; entegrasyonlar için onaylama uç noktasıdır.

Onay, yayını bekletmeden çıkarır ve normal inceleme kuyruğuna taşır. Onay için analizin tamamlanmış olması gerekir: yayını son çalıştırmadan sonra düzenlediyseniz, onaylamadan önce güncellenen raporu bekleyin.

6. Normal inceleme

Onaydan sonra yayınınız tıpkı diğerleri gibi incelenir. İnceleme sırasında neler olduğu, ne kadar sürdüğü ve olası sonuçlar için Doğrulama ve inceleme bölümüne bakın.

Kalite raporunu anlama

Kalite raporu iki bölümden oluşur: bir sorunlar listesi ve analiz çalıştırmasıyla ilgili küçük bir rapor ayrıntıları bloğu.

Sorunlar

Rapordaki her sorun, incelenecek bir noktayı açıklar. Üzerinde çalışacağınız alanlar:

Alan	Size ne söyler
Başlık	Sorun için kısa ve sade bir ad.
Mesaj	Sorunun ne olduğu ve bu konuda ne yapılacağı.
Önem derecesi	Öncelik vermenize yardımcı olacak şekilde, sorunun ne kadar önemli olduğu.
Engelleyici	Onaylayabilmeniz için sorunun çözülmesi gerekip gerekmediği (aşağıya bakın).
Geri bildirim gerektirir	Sorunun sizden yazılı bir yanıt veya yüklenen bir belge gerektirip gerektirmediği.
Özel açıklama	Mevcut olduğunda, yayınınıza özgü ek ayrıntılar.
Etkilenen parçalar	Sorunun hangi parçalara uygulandığı. Yayın düzeyindeki sorunlar belirli parçaları listelemez.

Engelleyici mi, bilgilendirici mi

• Engelleyici sorunların yayını incelemeye onaylayabilmeniz için çözülmesi gerekir. Açıkladıklarını düzeltin, analizin yeniden çalışmasına izin verin; raporunuzdan kaybolacaklardır.
• Bilgilendirici sorunlar, bir göz atmaya değer bir şeyi belirtmek için oradadır ancak onaylamanızı engellemez. Bunları gözden geçirin ve hazır olduğunuzda onaylayın.

Geri bildirim gerektiren sorunlar

Bazı sorunlar yalnızca düzenlemeyle çözülemez: sizden bir şey gerektirir; örneğin yazılı bir açıklama veya destekleyici bir belge (bir cover ya da örnekleme için lisans gibi). Bunlar geri bildirim gerektirir olarak işaretlenir. Böyle bir sorunu çözmek için, onaylamadan önce sorunun not dizisinde yanıt verin veya istenen belgeyi yükleyin.

Rapor ayrıntıları

Sorunların yanında rapor, analiz çalıştırmasıyla ilgili birkaç ayrıntı içerir:

Alan	Size ne söyler
generated_at	Mevcut raporun ne zaman oluşturulduğu. İlk analiz hâlâ çalışırken boştur.
checks_in_progress	Analiz hâlâ çalışırken true; bitene kadar sorun listesi boş olur.
hold	Yayının şu anda inceleme öncesi bekletmede olup olmadığı.
review_status	Yayının mevcut inceleme durumu.
profile	Bu yayına uygulanan kalite profili.

Entegrasyonlar için API’yi kullanma

LabelGrid herkese açık API’si üzerine geliştirme yapıyorsanız, Preflight QC’yi kendi hattınıza bağlayabilirsiniz: her yayını kalite analizinden geçirin, raporu kendi QA iş akışınıza çekin, iç onay sürecinizi buna dayandırın ve kendi araçlarınızdan incelemeye onaylayın. Preflight QC bunun için iki uç nokta sunar; her ikisi de herkese açık API’nin geri kalanıyla aynı Bearer belirteci kimlik doğrulamasını kullanır. Tam ve her zaman güncel istek ve yanıt şemaları için API başvurusuna bakın.

Kalite raporunu alma

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

Yayının mevcut kalite raporunu döndürür. Yanıt şunları taşır:

• issues[]: sorun başına bir giriş; her biri code (kararlı bir dize; bkz. Sorun kodlarıyla çalışma), title, message, severity, is_blocking, requires_feedback, custom_description ve affected_tracks içerir.
• report: generated_at, checks_in_progress, hold, review_status ve profile.

Analiz hâlâ çalışırken rapor, boş bir issues listesiyle birlikte checks_in_progress: true döndürür. generated_at ayarlanana kadar uç noktayı sorgulayın (polling); bu genellikle yükleme ve dönüştürme bittikten birkaç dakika sonra gerçekleşir. Ardından sorunları okuyun.

Analiz bittikten sonraki örnek bir yanıt:

{
  "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": "…"
  }
}

Yayını incelemeye onaylama

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

Yayını bekletmeden çıkarır ve normal inceleme kuyruğuna taşır: uygulamadaki onaylama düğmesinin API karşılığı.

Onay için analizin tamamlanmış olması gerekir. Yayın son analiz çalıştırmasından sonra düzenlendiyse rapor yeniden oluşturuluyordur ve uç nokta bir çakışma (conflict) döndürür. Bu durumda kalite raporunu yeniden alın, generated_at yeniden ayarlanana kadar bekleyin ve onayı yeniden deneyin.

Sorun kodlarıyla çalışma

Kalite raporunun üzerine mantık kuruyorsanız, bunu sorunun code alanına dayandırın:

• code kararlı bir dizedir. Slug biçimindedir (örneğin audio.trailing-silence); kodları sisteminizde eşleyip üzerlerine mantık kurmak güvenlidir.
• Başlıklar ve mesajlar insanlara yönelik metinlerdir. Zamanla iyileştirilebilirler; mantığınızı asla metne dayandırmayın ve metni yalnızca görüntüleme için kullanın.
• Yeni kodlar ortaya çıkabilir. Preflight QC’nin kapsamı genişledikçe yeni kodlar eklenir. Tanımadığınız kodları genel biçimde ele alın: hata vermek yerine yanıttaki title ve message alanlarını gösterin.
• Önemli kodları raporlarınız öğretir. Yayınlarınızı Preflight QC’den geçirdikçe, kataloğunuzla ilgili kodlar kendi kalite raporlarınızda doğal olarak ortaya çıkar.
• Analizin kapsamı. Sorunlar şu kategorilere ayrılır: yayın ve parça meta verileri, yayın tarihleri ve sürümleri, ses kalitesi, görsel, lisanslar ve belgeler.

Sorun kataloğu

Kendi QA iş akışınızı kurarken sorunları eşlemek için, kataloğun tamamını programatik olarak alın:

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

Bir kalite raporunda görünebilecek her sorunu, kararlı dize kodunu anahtar olarak döndürür; her kayıtta başlık, mesaj şablonu, önem derecesi, engelleme işareti ve requires_feedback bulunur. Bu uç nokta yalnızca Preflight QC eklentisine sahip hesaplara açıktır.

Sık sorulan sorular

Analiz hâlâ çalışıyorsa ne olur?

Rapor, henüz hiçbir sorun listelenmeden checks_in_progress: true gösterir. Bu, göndermenizin hemen ardından normaldir. Yükleme ve dönüştürme bittikten sonra birkaç dakika bekleyip tekrar bakın: uygulamada rapor kendi kendine güncellenir ve API üzerinden generated_at ayarlanana kadar sorgulayabilirsiniz.

Yayınım bekletmedeyken düzenleyebilir miyim?

Evet. İnceleme öncesi bekletmedeki bir yayını düzenlemek, analizin ilgili bölümlerini yeniden çalıştırır ve raporu günceller; böylece bekletmeden çıkmadan sorunları düzeltip güncellenen sonuçları görebilirsiniz. Yalnızca şunu unutmayın: bir düzenlemeden sonra onaylayabilmeniz için güncellenen raporu beklemeniz gerekir.

Onayladıktan sonra ne olur?

Yayınınız bekletmeden çıkar ve normal inceleme kuyruğuna katılır; burada diğerleri gibi incelenir. İncelemenin nasıl işlediği, ne kadar sürdüğü ve olası sonuçlar için Doğrulama ve inceleme bölümüne bakın.

Bir yayını taslağa geri döndürebilir miyim?

Evet: yayınınız inceleme öncesi bekletmedeyken ve henüz onaylamadıysanız, incelemeye girmemiştir; dolayısıyla düzenlemeyi sürdürmekte veya taslak olarak bırakıp sonra dönmekte özgürsünüz. Yayın, yalnızca siz onayladığınızda inceleme kuyruğuna girer.

Onaylamadan önce her sorunu düzeltmem gerekir mi?

Onaylayabilmeniz için engelleyici sorunları çözmeniz gerekir. Bilgilendirici sorunlar onaylamanızı engellemez, ama bir göz atmaya değer: incelemeden önce mümkün olduğunca çok şeyi toparlamak, onaya giden en hızlı yoldur.

---

Preflight QC hakkında sorularınız mı var? Ekibimizle iletişime geçin. Yardımcı olmaktan memnuniyet duyarız.