{"openapi":"3.1.0","info":{"title":"CarEV Integration & Showroom API","version":"1.0.0","description":"API กลางสำหรับเชื่อมระบบเว็บไซต์หน้าร้าน (www.carev.biz), สต็อกหลังบ้าน (office.carev.biz) และระบบงานขาย (sale.carev.biz)"},"servers":[{"url":"https://portal.carev.biz","description":"CarEV Portal Production API"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"ใส่คีย์ cev_live_... ที่ได้รับจาก Admin"},"BearerKey":{"type":"http","scheme":"bearer","description":"Authorization: Bearer cev_live_..."}}},"paths":{"/api/v1/public/ping":{"get":{"summary":"ตรวจสอบสถานะระบบ (Public Health Ping)","responses":{"200":{"description":"OK"}}}},"/api/v1/public/stock":{"get":{"summary":"ดึงรายการรถพร้อมขายที่เปิดขึ้นหน้าเว็บ carev.biz แล้ว","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"ค้นหายี่ห้อ/รุ่น/สี"}],"responses":{"200":{"description":"รายการรถพร้อมขายหน้าร้าน + รูป .webp"}}}},"/api/v1/public/stock/{id}":{"get":{"summary":"ดึงรายละเอียดรถหน้าเว็บรายคัน","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"รายละเอียดรถหน้าเว็บ"},"404":{"description":"ไม่พบหรือยังไม่เปิดขึ้นเว็บ"}}}},"/api/v1/integration/me":{"get":{"summary":"ตรวจสอบสถานะและสิทธิ์ (Scopes) ของ API Key","security":[{"ApiKeyHeader":[]},{"BearerKey":[]}],"responses":{"200":{"description":"ข้อมูล API Key และสิทธิ์ที่ได้รับ"}}}},"/api/v1/integration/stock":{"get":{"summary":"ดึงรายการรถในสต็อกหลังบ้านแบบ Realtime","security":[{"ApiKeyHeader":[]},{"BearerKey":[]}],"parameters":[{"name":"stage","in":"query","schema":{"type":"string","enum":["ALL","PENDING_RECEIPT","PREPARING","READY","RESERVED","PUBLISHED","SOLD","EXITED"]}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":200}}],"responses":{"200":{"description":"รายการรถในคลัง"}}}},"/api/v1/integration/stock/{id}":{"get":{"summary":"ดึงข้อมูลสเปกรถและรูปทั้งหมดรายคัน","security":[{"ApiKeyHeader":[]},{"BearerKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"ข้อมูลรถรายคัน"}}}},"/api/v1/integration/stock/{id}/reserve":{"post":{"summary":"จองรถ (RESERVE) หรือปลดจองรถ (RELEASE) จากระบบขาย","security":[{"ApiKeyHeader":[]},{"BearerKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["RESERVE","RELEASE"]},"reservedNote":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"อัปเดตสถานะจองสำเร็จ"}}}},"/api/v1/integration/cases":{"get":{"summary":"ดึงรายการความคืบหน้าเคสรับซื้อรถ (ปกปิดข้อมูลส่วนบุคคลผู้ขาย)","security":[{"ApiKeyHeader":[]},{"BearerKey":[]}],"parameters":[{"name":"status","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"รายการเคสรับซื้อรถ"}}}}}}