---
title: "Schema / Version Change Incident Playbook"
description: "Provider API veya feed schema değişikliklerinde parse, validation ve mapping kırılmalarını version gate, quarantine ve rollback ile yönetin."
slug: "schema-version-change-incident-playbook"
translationKey: "playbook-schema-version-change"
locale: "tr"
type: "playbook"
category: "operations"
tags: ["schema","api-version","feed","incident","compatibility"]
publishedAt: "2026-09-26"
updatedAt: "2026-09-26"
reviewedAt: "2026-09-26"
---

Schema/version incident, provider contract değişikliğinin parser veya normalized model'i kırmasıdır.

## Trigger

Parse error spike, unknown enum, missing required field, sudden reject-rate artışı veya provider deprecation bildirimi.

## Triage

1. Son başarılı payload ile ilk hatalı payload'ı diff edin.
2. Version/header/schema marker değişti mi?
3. Breaking field rename/type/enum var mı?
4. Parser backward-compatible mı?
5. Bad data downstream'a yazıldı mı?

## Containment

Yeni schema'yı version gate ile quarantine edin. Tüm batch'i sessizce kabul etmeyin. Gerekirse eski parser'a rollback veya affected provider'ı degrade mode'a alın.

## Migration

Old/new DTO'ları ayrı tutun; normalized internal model'e mapper version ekleyin. Shadow parse ile output farkını ölçün.

## Stop condition

Reject/error baseline'a dönmeli, sampled payload'lar doğru normalize edilmeli ve downstream corruption olmamalı.

## Metrikler

Schema reject rate, unknown-field/enum rate, parser-version distribution, quarantine size ve migration mismatch.

## Önleme

Contract fixture, schema snapshot, deprecation calendar ve provider version inventory tutun.