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, yapay zekâ içeriği, katalog tanımlayıcıları, önceki dağıtım 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, yapay zekâ içeriğini, katalog tanımlayıcılarını, önceki dağıtımı 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
• Yapay zekâ içeriği: yapay zekâ kullanımının beyan edilip edilmediği ve tespit ettiğimiz yapay zekâ üretimi müzik veya kapaklar
• Katalog tanımlayıcıları: ISRC’lerinizin geçerli olup olmadığı ve bir kaydın başka bir hak sahibi tarafından hâlihazırda talep edilip edilmediği
• Önceki dağıtım: yayının veya parçalarının başka bir dağıtımcı üzerinden mağazalarda zaten bulunup bulunmadığı
• 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, mevcut raporu eskimiş olarak işaretler: bulgular artık yayınınızın en güncel durumunu yansıtmaz. Dilediğiniz kadar düzenleyin, sonra yeni bir analiz isteyin; uygulamada yayın sayfasından ya da entegrasyonlar için yenileme uç noktası üzerinden. Analiz yeniden çalışır ve rapor yeni sonuçlarla güncellenir. Bu döngüyü ihtiyaç duyduğunuz kadar tekrarlayabilirsiniz; yayın başına saatte kaç yeni analiz başlatabileceğinize dair adil kullanım sınırı dahilinde.

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 tamamlanmış ve güncel bir analiz gerekir: yayını son çalıştırmadan sonra düzenlediyseniz rapor eskimiştir; bu yüzden yeni bir analiz isteyin ve onaylamadan önce bitmesini 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.
Kanıt	Tarih, yinelenen (duplicate) ve önceki dağıtım sorunlarında, bulduğumuz eşleşen yayınlar; böylece çakışmayı kendiniz kontrol edebilirsiniz (aşağıya bakın).

Engelleyici mi, bilgilendirici mi

• Engelleyici sorunların yayını incelemeye onaylayabilmeniz için çözülmesi gerekir. Açıkladıklarını düzeltin, yeni bir analiz çalıştırın; 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.

Bir sorundaki kanıt

Bazı sorunlar, bir işareti tahmin yürütmeden kontrol etmenize yardımcı olacak kanıt içerir: sizinkiyle eşleştirdiğimiz mevcut yayınlar. Bunu tarih, yinelenen ve önceki dağıtım sorunlarında görürsünüz. Her eşleşme; eşleşen parçanın başlığını ve sanatçısını, ait olduğu yayının başlığını, yayın tarihini ve ISRC’sini, ayrıca o yayının yayında olduğu bir mağazaya bağlantıyı ve hangi parçalarınızı etkilediğini gösterir. Parça başına en fazla üç eşleşme listelenir. Nasıl yanıt vereceğinize karar vermeden önce çakışmanın gerçek olup olmadığını (örneğin, kendinize ait daha önceki bir yükleme) doğrulamak için kanıtı kullanın.

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.
stale	Yayını (veya parçalarından herhangi birini) son tamamlanan analizden sonra düzenlediğinizde true olur; böylece bulgular artık mevcut durumu yansıtmaz. Her düzenleme sayılır. Raporu güncellemek için yeni bir analiz isteyin.
hold	Yayının şu anda inceleme öncesi bekletmede olup olmadığı.
review_status	Yayının mevcut inceleme durumu.
release_status	Yayının kendisinin genel durumu; incelemeye özgü durumun yanı sıra.
profile	Bu yayına uygulanan kalite profili; adı ve sürümüyle birlikte.

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 üç uç nokta sunar; hepsi 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.

Webhook: rapor hazır olduğunda haberdar olun

Sonuçları sürekli sorgulamak yerine, bir rapor hazır olduğu anda LabelGrid’in size haber vermesini sağlayabilirsiniz. release.preflight.report_ready webhook olayına abone olun: Preflight QC, inceleme öncesi bekletmedeki bir yayını analiz etmeyi bitirir bitirmez tetiklenir; bu, istediğiniz her yeniden analizin tamamlandığı anları da kapsar. Her analiz döngüsü için tam olarak bir olay alırsınız.

LabelGrid’in diğer yayın webhook olaylarına abone olduğunuz gibi, uygulamadaki webhook ayarlarınızdan veya API üzerinden abone olun. Her olay, çalıştırmanın kısa bir özetini taşır, hiçbir zaman sorunların kendisini değil:

• Yayın tanımlayıcıları: release_id, label_id, release_cat ve release_title.
• generated_at: bu raporun ne zaman oluşturulduğu. Raporun kendi generated_at değeriyle eşleşir.
• profile: sayıların hesaplandığı kalite profili, {name, version} biçiminde.
• counts: blocking, informational ve requires_feedback toplamları. requires_feedback sayısı diğer ikisiyle örtüşür.

Harekete geçmeniz gerekip gerekmediğine karar vermek için sayıları kullanın, sonra ayrıntı için raporun kendisini çekin. Önerilen entegrasyon deseni:

1. release.preflight.report_ready olayına abone olun.
2. Her olayda, sorunların tam listesini okumak için Kalite raporunu alma uç noktasını çağırın.
3. Düzeltin ve yeniden çalıştırın: bekletmedeki bir yayını düzenledikten sonra, yeni bir analiz başlatmak için yenileme uç noktasını çağırın; tamamlandığında webhook yeniden tetiklenir.
4. Yayın kendi çıtanızı aştığında, kendi araçlarınızdan karar verin ve onaylayın.

Tam yük (payload) başvurusu ve webhook mekaniği (imzalama, yeniden denemeler ve zarf yapısı) için bkz. Webhooks.

Kalite raporunu alma

GET /api/public/releases/{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 id, code (kararlı bir dize; bkz. Sorun kodlarıyla çalışma), title, message, status, severity, is_blocking, requires_feedback, custom_description ve affected_tracks içerir. Tarih, yinelenen ve önceki dağıtım sorunlarında giriş, ayrıca bir evidence dizisi taşır (aşağıya bakın).
• report: generated_at, checks_in_progress, stale, hold, review_status, release_status ve profile (name ve version içeren bir nesne). Yayın veya parçalarından herhangi biri son tamamlanan analizden sonra düzenlendiğinde stale, true olur; onaylamadan önce yenileme uç noktası ile analizi yeniden çalıştırın.

Analiz hâlâ çalışırken rapor, boş bir issues listesiyle birlikte checks_in_progress: true döndürür. Webhook kullanmak istemiyorsanız, generated_at ayarlanana kadar bu 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. Bunun yerine rapor hazır olduğu anda haberdar olmak için rapor hazır webhook’unu kullanın.

Analiz bittikten sonraki örnek bir yanıt:

{
  "issues": [
    {
      "id": "12345",
      "code": "example.issue-code",
      "title": "Short issue title",
      "message": "What to fix and how.",
      "status": "confirmed",
      "severity": "…",
      "is_blocking": true,
      "requires_feedback": false,
      "custom_description": null,
      "affected_tracks": [456],
      "evidence": [
        {
          "affected_track_id": 456,
          "track_title": "Matched track title",
          "artist": "Matched artist",
          "release_title": "Matched release",
          "release_date": "2024-03-01",
          "isrc": "USRC12345678",
          "store_url": "https://…"
        }
      ]
    }
  ],
  "report": {
    "generated_at": "2026-07-07T12:00:00Z",
    "checks_in_progress": false,
    "stale": false,
    "hold": true,
    "review_status": "…",
    "release_status": "…",
    "profile": { "name": "quality_report", "version": 2 }
  }
}

Her evidence öğesi, sizinkiyle eşleşen mevcut bir yayını açıklar: affected_track_id (eşleşmenin parçalarınızdan hangisine uygulandığı), eşleşen track_title, artist, release_title, release_date ve isrc, ayrıca eşleşmenin yayında olduğu bir mağaza sayfasına işaret eden bir store_url. Parça başına en fazla üç eşleşme listelenir ve bu anahtar yalnızca yukarıdaki sorun türlerinde bulunur.

Yeni bir analiz isteme

POST /api/public/releases/{id}/quality-report/refresh
Authorization: Bearer YOUR_API_TOKEN

Bekletmedeki bir yayın için yeni bir Preflight QC analiz döngüsü başlatır. Bekletmedeki bir yayını düzenlemek, kontrolleri kendi başına yeniden çalıştırmaz: yalnızca mevcut raporu eskimiş olarak işaretler (report.stale: true). Düzenlemeyi bitirdiğinizde, analizi yeniden çalıştırmak için bu uç noktayı çağırın; döngü tamamlandığında rapor hazır webhook’u tetiklenir ve report.stale yeniden false olur.

Başarılı bir çağrı 202 Accepted döndürür:

{
  "status": "refreshing",
  "checks_in_progress": true,
  "review_status": "pending_customer_review",
  "release_status": "to_review"
}

Çağrı, bir döngü çalışırken idempotenttir: yeniden çağırmak aynı, devam etmekte olan yanıt gövdesini döndürür, ikinci bir analizi kuyruğa almaz ve bütçenizden düşmez. Ele almanız gereken diğer yanıtlar:

• 409 not_in_customer_review_hold: yayın şu anda Preflight QC incelemeniz için bekletmede değil.
• 409 refresh_coalesced: bu yayın için bir analiz az önce tamamlandı, bu yüzden hiçbir şey kuyruğa alınmadı. Retry-After başlığından (saniye) sonra yeniden deneyin.
• 429 preflight_recheck_limit_reached: yayın başına, kayan bir saat içinde başlatılan 6 analiz döngüsü adil kullanım bütçesine ulaştınız. Retry-After başlığı (saniye), bir sonraki yenilemeye ne zaman izin verildiğini bildirir. Devam eden bir analizi sorgulamak ücretsizdir; yalnızca yeni bir döngü başlatmak bütçe harcar.
• 403 RELEASE_NOT_VALIDATED: yeniden analiz başlayabilmeden önce yayının doğrulamadan geçmesi gerekir (dağıtımdaki kuralın aynısı); önce doğrulamayı çalıştırın.
• 403 pre_review_qc_not_enabled: Preflight QC, sahibi olan hesap için etkin değil.

Yayını incelemeye onaylama

POST /api/public/releases/{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 tamamlanmış ve güncel bir analiz gerekir. Ele alınması gereken iki çakışma:

• 409 checks_in_progress: analiz hâlâ çalışıyor. Rapor hazır webhook’unu bekleyin (veya generated_at ayarlanana kadar sorgulayın), sonra yeniden deneyin.
• 409 checks_stale: yayın son tamamlanan analizden sonra düzenlendi (report.stale, true). Yenileme uç noktasını çağırın, yeni raporu bekleyin, sonra onayı yeniden deneyin.

Not

Bir yayın inceleme öncesi bekletmedeyken, onu normal dağıtım yolundan göndermek 409 preflight_recheck_required döndürür: bekletmedeki bir yayın, yalnızca burada anlatılan yenileme ve onaylama akışıyla bekletmeden çıkar.

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, yapay zekâ içeriği, katalog tanımlayıcıları, önceki dağıtım, 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 /api/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, requires_feedback ve kategorisi (type) bulunur. Yanıt ayrıca, kataloğun hesaplandığı kalite profilini {name, version} biçiminde taşır. 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. API üzerinden, hazır olduğu anda size bildirim gönderilmesi için rapor hazır webhook’una abone olabilir ya da generated_at ayarlanana kadar sorgulayabilirsiniz.

Yayınım bekletmedeyken düzenleyebilir miyim?

Evet, dilediğiniz kadar özgürce düzenleyin: inceleme öncesi bekletmedeki bir yayın tümüyle düzenlenebilir kalır. Düzenlemek, kontrolleri kendi başına yeniden çalıştırmaz; mevcut raporu eskimiş olarak işaretler. Değişikliklerinizi bitirdiğinizde, bekletmeden çıkmadan güncellenen sonuçları görmek için yeni bir analiz isteyin (uygulamada yayın sayfasından ya da entegrasyonlar için yenileme uç noktası üzerinden). Yeni analizin, onaylayabilmeniz için tamamlanması 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.