{"openapi":"3.1.0","info":{"title":"HOPPx Core + HOPPcars Smart Dealer Platform API","version":"1.0.0","description":"Multi-tenant B2B & B2C modular monolith API for HOPPcars Smart Dealer (hoppdealer.hu), HOPPcars Central Federation (hoppcars.hu), HOPPGrow, HOPPx Partners (partner.hoppx.hu) and HOPPx Loyalty QR (kartya.hoppx.hu). Enforces PostgreSQL Row Level Security (RLS), mandatory 2FA TOTP, Idempotency-Key on state-mutating billing/publication/referral operations, and Tibor Legal Package compliance.","contact":{"name":"HOPPX Ltd. / Tercsinecz Martin (RISE RFID s.r.o.)","url":"https://hoppdealer.hu","email":"martin.tercsinecz@gmail.com"}},"servers":[{"url":"https://api.hoppdealer.hu","description":"Production API Server (Nürnberg/Falkenstein EU)"},{"url":"https://api.hopphomes.hu","description":"HOPPhomes Ecosystem API Alias"},{"url":"https://hopphomes.hu","description":"HOPPhomes Primary Gateway"},{"url":"https://hoppdealer.hu","description":"Smart Dealer Primary Gateway Proxy"}],"paths":{"/v1/openapi.json":{"get":{"summary":"Public OpenAPI 3.1 specification for client generation","tags":["Core"]}},"/v1/.well-known/jwks.json":{"get":{"summary":"Public Ed25519 (EdDSA / OKP) JSON Web Key Set for Handoff Token verification","tags":["Core","Central Federation"]}},"/v1/handoff/{hid}/verify":{"get":{"summary":"Verify Ed25519 signed referral handoff token by handoff ID or JWT string","tags":["Central Federation"]}},"/v1/health/metrics":{"get":{"summary":"Health, database, RLS status, and worker queue wait time metrics","tags":["Core"]}},"/internal/tls/allow":{"get":{"summary":"Caddy On-Demand TLS domain verification gate","tags":["Infrastructure"]}},"/v1/public/b2b-landing":{"get":{"summary":"hoppdealer.hu B2B sales page configuration, packages, and live feature status registry","tags":["B2B Sales"]}},"/v1/public/b2b-signup":{"post":{"summary":"Submit dealer test-partner / demo request into Customer Generator funnel","tags":["B2B Sales"]}},"/v1/public/resolve-tenant":{"get":{"summary":"Resolve dealer tenant by Host header or slug with brand, legal, and inventory data","tags":["Website Factory"]}},"/v1/tenants":{"get":{"summary":"List tenants (HOPPx Operator only)","tags":["Website Factory"]},"post":{"summary":"Provision a new dealer or plaza tenant via Website Factory configuration","tags":["Website Factory"]}},"/v1/tenants/{id}/domains":{"post":{"summary":"Configure custom domain, DNS verification, 301 redirect map, and SSL","tags":["Website Factory"]}},"/v1/tenants/{id}/legal":{"patch":{"summary":"Update tenant legal configuration and re-validate mandatory placeholders","tags":["Legal & Consent"]}},"/v1/tenants/{id}/publish":{"post":{"summary":"Publish dealer website (blocked if mandatory legal fields are incomplete)","tags":["Website Factory"]}},"/v1/dealers/{slug}/inventory":{"get":{"summary":"Search and filter dealer vehicle inventory with shareable URL parameters","tags":["Inventory"]}},"/v1/dealers/{slug}/inventory/{listingSlug}":{"get":{"summary":"Get detailed vehicle datasheet with original & digital showroom photos","tags":["Inventory"]}},"/v1/tenants/{tenantId}/ai-upload/draft":{"post":{"summary":"10-step mobile AI vehicle upload: malware/EXIF scan, quality check, showroom composite & fact-based text draft","tags":["AI Upload & Showroom"]}},"/v1/tenants/{tenantId}/listings":{"get":{"summary":"List tenant vehicles (RLS enforced)","tags":["Inventory"]},"post":{"summary":"Create or publish vehicle listing (enforces plan active car quota & human approval)","tags":["Inventory"]}},"/v1/hoppy/sessions":{"post":{"summary":"Start a HOPPY AI session in Dealer Assistant or B2B Sales mode","tags":["HOPPY Agent"]}},"/v1/hoppy/chat":{"post":{"summary":"Send message to HOPPY with 12 tool calls, local-first search, and human handoff","tags":["HOPPY Agent"]}},"/v1/dealers/{slug}/leads":{"post":{"summary":"Submit buyer lead (website form, callback, offer request)","tags":["HOPPOS CRM"]}},"/v1/dealers/m1autoplaza/plaza-inquiry":{"post":{"summary":"Submit M1 AutoPláza dealer space leasing inquiry (\"Bérlőként csatlakoznék\")","tags":["M1 AutoPláza"]}},"/v1/tenants/{tenantId}/leads":{"get":{"summary":"List tenant CRM leads (strictly isolated via PostgreSQL RLS)","tags":["HOPPOS CRM"]}},"/v1/tenants/{tenantId}/leads/{leadId}/confirm-sale":{"post":{"summary":"Confirm vehicle sale (SALE_CONFIRMED) and issue HOPPx QR discount card invite","tags":["HOPPOS CRM"]}},"/v1/central/search":{"get":{"summary":"HOPPcars central federated inventory search (only explicitly opted-in vehicles, with ranking explanation)","tags":["Central Federation"]}},"/v1/network/handoff":{"post":{"summary":"Issue signed referral handoff token to HOPPcars Central or Finance with consent snapshot","tags":["Central Federation"]}},"/v1/finance/referrals":{"post":{"summary":"Initiate central HOPPcars finance assessment handoff (no bank docs stored in dealer CRM)","tags":["Finance Handoff"]}},"/v1/tenants/{tenantId}/billing":{"get":{"summary":"Get tenant subscription, usage meters, 80% warnings, hard caps, and Wise proforma invoices","tags":["Billing & Entitlements"]}},"/v1/admin/cost-margin-report":{"get":{"summary":"Per-tenant and per-plan direct cost & gross software margin report (65–70% target)","tags":["Billing & Entitlements"]}},"/v1/dealers/{slug}/trade-in":{"post":{"summary":"Submit TRADE-IN vehicle valuation request","tags":["Ecosystem 10/B"]}},"/v1/tenants/{tenantId}/deal-rooms":{"post":{"summary":"Open secure buyer DEAL ROOM for serious inquiry","tags":["Ecosystem 10/B"]}},"/v1/public/cmp-consent":{"post":{"summary":"Record per-tenant CMP cookie consent decision","tags":["Legal & Consent"]}},"/v1/public/dsa-report":{"post":{"summary":"Submit DSA Notice-and-Action illegal/misleading listing report (\"Jelentem a hirdetést\")","tags":["Legal & Consent"]}},"/v1/tenants/{tenantId}/dsar-tickets":{"post":{"summary":"Create GDPR Data Subject Access/Erasure Request (DSAR) ticket","tags":["Legal & Consent"]}},"/v1/tenants/{tenantId}/export":{"post":{"summary":"Export tenant own vehicles, media, leads, and settings (Data Act JSON/CSV/ZIP)","tags":["Legal & Consent"]}},"/v1/admin/feature-status":{"get":{"summary":"List 11/A feature status registry and automated acceptance test results","tags":["Governance 11/A"]}},"/v1/admin/demo-guide":{"get":{"summary":"16-step live sales walkthrough guide with real-time verification status","tags":["Governance 11/A"]}},"/v1/homes/resolve-tenant":{"get":{"summary":"Resolve HOPPhomes partner agency, builder, developer or admin app by Host/slug","tags":["HOPPhomes F01-F02"]}},"/v1/homes/onboarding":{"post":{"summary":"Self-service partner onboarding (<10 min wizard) with template & domain provisioning","tags":["HOPPhomes F01-F02"]}},"/v1/homes/tenants/{id}/blocks":{"put":{"summary":"Update partner page builder blocks with XSS sanitization","tags":["HOPPhomes F01-F02"]}},"/v1/homes/marketplace/search":{"get":{"summary":"National opt-in marketplace search with duplicate cluster deduplication & spatial filters","tags":["HOPPhomes F03-F04"]}},"/v1/homes/listings/{slugOrId}":{"get":{"summary":"Get property datasheet, original vs AI-concept media, and multi-agency offers","tags":["HOPPhomes F03-F04"]}},"/v1/homes/listings/{id}/syndicate":{"post":{"summary":"Opt-in or immediately revoke national marketplace syndication","tags":["HOPPhomes F04"]}},"/v1/homes/ai/upload-analyze":{"post":{"summary":"AI property upload analysis: room classification, floorplan sqm, HU/EN copy & yellow verification prompts","tags":["HOPPhomes F05"]}},"/v1/homes/ai/visualize":{"post":{"summary":"AI virtual staging, decluttering, renovation, day-to-dusk & video tour (original photo protected)","tags":["HOPPhomes F06"]}},"/v1/homes/hoppy/chat":{"post":{"summary":"HOPPY Real Estate AI Manager: natural language search, Land & Build matcher, cross-vertical & human handoff","tags":["HOPPhomes F07"]}},"/v1/homes/leads":{"post":{"summary":"Create property/plot/build lead routed to original partner with ReferralAttribution & HoppOS sync","tags":["HOPPhomes F08 & F25"]}},"/v1/homes/tenants/{tenantId}/crm":{"get":{"summary":"Tenant-isolated Agency Manager CRM dashboard, Kanban pipelines, SLA alerts & commissions","tags":["HOPPhomes F08 & F20"]}},"/v1/homes/plots":{"get":{"summary":"List plots with geometric analysis and HÉSZ zoning status","tags":["HOPPhomes F10"]},"post":{"summary":"Free plot upload (for_sale or have_plot_seeking_house) with preliminary HÉSZ check","tags":["HOPPhomes F10"]}},"/v1/homes/house-models":{"get":{"summary":"House catalogue & HOPPhomes Reference House variants (enforces verified PriceList rule)","tags":["HOPPhomes F11"]}},"/v1/homes/builders":{"get":{"summary":"Verified builder network & HOPP Solid partners with capacity slots","tags":["HOPPhomes F11"]}},"/v1/homes/land-and-build/match":{"post":{"summary":"AI Plot + House Model + Builder matcher with itemized cost range","tags":["HOPPhomes F12"]}},"/v1/homes/configurator/estimate":{"post":{"summary":"Create itemized total construction cost estimate with shareable link & PDF export","tags":["HOPPhomes F13"]}},"/v1/homes/projects":{"get":{"summary":"List residential park development projects with unit status counts","tags":["HOPPhomes F14"]}},"/v1/homes/projects/{slug}":{"get":{"summary":"Get residential park project, buildings, 40 units & interactive SVG facade zones","tags":["HOPPhomes F14"]}},"/v1/homes/vault/teasers":{"get":{"summary":"List anonymous VAULT teasers (Market & Elite) without exposing HIDDEN deals or exact addresses","tags":["HOPPhomes VAULT F15-F16"]}},"/v1/homes/vault/deals/{dealId}/request-access":{"post":{"summary":"Submit investor access request with justification (manual approval only)","tags":["HOPPhomes VAULT F15-F16"]}},"/v1/homes/vault/deals/{dealId}/sign-nda":{"post":{"summary":"Sign electronic per-deal NDA with SHA-256 document & signature hash","tags":["HOPPhomes VAULT F15-F16"]}},"/v1/homes/vault/deals/{dealId}/deal-room":{"get":{"summary":"Open 2FA-protected VAULT Deal Room with granular scope decryption & HOPPY sensitivity analysis","tags":["HOPPhomes VAULT F15-F16"]}},"/v1/homes/vault/documents/{docId}/view":{"get":{"summary":"View protected VAULT document with dynamic per-user watermark & immutable audit log","tags":["HOPPhomes VAULT F15-F16"]}},"/v1/homes/vault/grants/{grantId}/revoke":{"post":{"summary":"One-click immediate revocation of VAULT access grant & session generation invalidation","tags":["HOPPhomes VAULT F15-F16"]}},"/v1/homes/vault/deals/{dealId}/break-glass":{"post":{"summary":"Super Admin break-glass access with mandatory justification & CRITICAL audit log","tags":["HOPPhomes VAULT F15 & F22"]}},"/v1/homes/vault/deals/{dealId}/audit-export":{"get":{"summary":"Export immutable VAULT audit log (CSV / JSON)","tags":["HOPPhomes VAULT F15"]}},"/v1/homes/finance/calculate":{"post":{"summary":"Preliminary mortgage & construction budget calculator","tags":["HOPPhomes F17"]}},"/v1/homes/hoppdeal/offers":{"get":{"summary":"Contextual HOPPDeal home service partner offers","tags":["HOPPhomes F18"]}},"/v1/homes/hoppgrow/generate-campaign":{"post":{"summary":"One-click HOPPGrow AI marketing creative pack & targeting generator","tags":["HOPPhomes F19"]}},"/v1/homes/admin/overview":{"get":{"summary":"Platform Super Admin overview, demo switch, legal switches & VAULT metadata monitor","tags":["HOPPhomes F21-F22"]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}}}