Aksesuar uyumluluğu

/api/v1/uyumluluk — PUT

PUT/api/v1/uyumluluk

Uyumluluk satırlarını toplu yaz

Aksesuar ↔ cihaz uyumluluğunu toplu yazar: urun_ref aksesuarın item_ref’i, karşısında uyumlu_ref (cihazın item_ref’i) ya da uyumlu_model_adi (“iPhone 15 Pro”); sonuc uyumlu ya da uyumsuz. Satırlar hemen etkin olur ve asistan “bu kılıf telefonuma olur mu?” sorusunu bununla yanıtlar. Hatalı satırlar hatalar’da sıra numarasıyla döner. En çok 1000 satır; büyük katalogda her parçayı aynı sync_id ile gönderin, sonuncusuna final=true ekleyin.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: ingest:catalog
• Paket özelliği: Uyumluluk — kapalıysa uç 404 not_found döner
• Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
full	query	boolean	varsayılan false	true: listede olmayan kayıtlar pasiflenir (ek- önekli elle eklenen bilgi satırları korunur). Tam liste tek istekte (≤1000) gönderilmeli.
sync_id	query	string | null	min 1, max 80, ^[A-Za-z0-9_.:-]+$	Parçalı tam senkron oturumu; tüm parçalarda aynı değer.
final	query	boolean	varsayılan false	Parçalı senkronun son parçası: oturumda gelmeyen API satırları silinir.

İstek gövdesi (application/json)

• ile işaretli alanlar zorunludur. Bilinmeyen alan 422 ile reddedilir.

CompatBatch

Alan	Tür	Sınır	Anlamı
items *	CompatIn[]	en az 1, en çok 1000

CompatIn

Alan	Tür	Sınır	Anlamı
urun_ref *	string	min 1, max 200
uyumlu_ref	string | null	max 200
uyumlu_model_adi	string | null	max 200
sonuc	"uyumlu" | "uyumsuz"	varsayılan "uyumlu"
not	string | null	max 500

Örnek

curl -s -X PUT "$RZ_API/api/v1/uyumluluk" -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"urun_ref": "kilif-123", "uyumlu_model_adi": "iPhone 15 Pro", "sonuc": "uyumlu"}]}'

Yanıt 200

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.