Accessory compatibility

/api/v1/uyumluluk — PUT

PUT/api/v1/uyumluluk

Writes accessory ↔ device compatibility in bulk: urun_ref is the accessory’s item_ref, matched to uyumlu_ref (the device’s item_ref) or uyumlu_model_adi (“iPhone 15 Pro”); sonuc is uyumlu (compatible) or uyumsuz (not compatible). Rows take effect immediately and the assistant uses them to answer “will this case fit my phone?”. Invalid rows come back in hatalar with their position. Up to 1000 rows; for a large catalog send every part with the same sync_id and add final=true to the last one.

• Authentication: Authorization: Bearer rz_live_…
• Scope: ingest:catalog
• Plan feature: Compatibility — if off, the endpoint answers 404 not_found
• Idempotency-Key: optional (recommended for retries)

Parameters

Name	In	Type	Limits	Meaning
full	query	boolean	default false	true: records missing from the list are deactivated (ek- hand-added knowledge rows are kept). Send the full list in one request (≤1000).
sync_id	query	string | null	min 1, max 80, ^[A-Za-z0-9_.:-]+$	Chunked full-sync session; the same value in every part.
final	query	boolean	default false	Last part of a chunked sync: API rows not sent in this session are removed.

Request body (application/json)

Fields marked * are required. Unknown fields are rejected with 422.

CompatBatch

Field	Type	Limits	Meaning
items *	CompatIn[]	min items 1, max items 1000

CompatIn

Field	Type	Limits	Meaning
urun_ref *	string	min 1, max 200
uyumlu_ref	string | null	max 200
uyumlu_model_adi	string | null	max 200
sonuc	"uyumlu" | "uyumsuz"	default "uyumlu"
not	string | null	max 500

Example

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"}]}'

Response 200

Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.