{"openapi":"3.1.0","info":{"title":"iStores PriceWatch API","version":"1.0.0","description":"מחירי מתחרים מנורמלים לפי מק״ט, רשת וסניף."},"servers":[{"url":"https://pricewatch.istores.co.il"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/prices":{"get":{"summary":"מחירים נוכחיים לפי מק״ט","parameters":[{"name":"sku","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain","in":"query","schema":{"type":"string"}},{"name":"store","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":250,"default":100}}],"responses":{"200":{"description":"Price list"},"401":{"description":"Invalid API key"}}}},"/api/v1/products/{sku}/prices":{"get":{"summary":"מחירים והיסטוריה למוצר","parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product prices and 90-day history"},"404":{"description":"SKU not found"}}}},"/api/v1/snapshots/{date}":{"get":{"summary":"Snapshot יומי למק״טים של הלקוח","parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date"}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":500,"default":200}},{"name":"changed_only","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Paginated daily snapshot"}}}},"/api/v1/mappings":{"get":{"summary":"רשימת מיפויי מק״טים של הלקוח","security":[{"bearerAuth":["catalog:write"]}],"parameters":[{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":500,"default":200}},{"name":"active","in":"query","schema":{"type":"string","enum":["true","false","all"],"default":"true"}}],"responses":{"200":{"description":"Paginated mapping list"}}},"put":{"summary":"הוספה או עדכון של מיפויי מק״טים","security":[{"bearerAuth":["catalog:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","maxItems":500,"items":{"type":"object","required":["sku"],"properties":{"sku":{"type":"string"},"external_product_id":{"type":["string","null"]},"field_mapping":{"type":"object","additionalProperties":{"type":"string"}}}}}}}}}},"responses":{"200":{"description":"Mappings upserted"},"422":{"description":"Tenant SKU limit exceeded"}}},"delete":{"summary":"השבתת מיפוי מק״ט","security":[{"bearerAuth":["catalog:write"]}],"parameters":[{"name":"sku","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Mapping disabled"},"404":{"description":"Mapping not found"}}}},"/api/v1/webhooks":{"get":{"summary":"רשימת Webhook endpoints","security":[{"bearerAuth":["webhooks:write"]}],"responses":{"200":{"description":"Webhook endpoint list"}}},"post":{"summary":"רישום Webhook endpoint","security":[{"bearerAuth":["webhooks:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}},"responses":{"201":{"description":"Endpoint created; secret is returned once"},"400":{"description":"Invalid or non-public URL"}}},"delete":{"summary":"כיבוי Webhook endpoint","security":[{"bearerAuth":["webhooks:write"]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Endpoint disabled"},"404":{"description":"Endpoint not found"}}}},"/api/v1/webhooks/test":{"post":{"summary":"הוספת מסירת Webhook לבדיקה לתור","security":[{"bearerAuth":["webhooks:write"]}],"responses":{"202":{"description":"Delivery queued"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"PriceWatch API key"}}}}