{"openapi":"3.1.0","info":{"title":"Aviso.Gratis Public API","version":"0.1.0","description":"Endpoints publicos para descubrimiento AI-friendly y acciones medibles sin exponer PII del anunciante."},"servers":[{"url":"http://localhost:3000"}],"paths":{"/api/public/search":{"get":{"summary":"Buscar micrositios e items publicos","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"niche","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Resultados publicos sin PII"}}}},"/api/public/locations":{"get":{"summary":"Paises y ciudades disponibles","responses":{"200":{"description":"Indice de ubicaciones"}}}},"/api/public/niches":{"get":{"summary":"Nichos disponibles","responses":{"200":{"description":"Catalogo de nichos"}}}},"/api/public/microsites/{slug}/catalog.json":{"get":{"summary":"Catalogo publico de un micrositio","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Catalogo seguro"},"404":{"description":"No encontrado"}}}},"/api/public/items/{id}.json":{"get":{"summary":"Ficha publica de item","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Item seguro"},"404":{"description":"No encontrado"}}}},"/api/public/leads":{"post":{"summary":"Crear intencion de contacto","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLead"}}}},"responses":{"201":{"description":"Lead creado. Regresa redirect_url para abrir WhatsApp despues del valor generado."}}}},"/go/whatsapp/{token}":{"get":{"summary":"Redirect seguro hacia WhatsApp del anunciante","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"302":{"description":"Redirect a wa.me"},"404":{"description":"Token invalido"}}}}},"components":{"schemas":{"CreateLead":{"type":"object","required":["visitor"],"properties":{"storeSlug":{"type":"string"},"itemId":{"type":"string"},"visitor":{"type":"object","required":["name","whatsapp","acceptedTerms"],"properties":{"name":{"type":"string"},"whatsapp":{"type":"string"},"email":{"type":"string"},"notes":{"type":"string"},"acceptedTerms":{"type":"boolean"}}},"items":{"type":"array","items":{"type":"object","required":["itemId"],"properties":{"itemId":{"type":"string"},"quantity":{"type":"integer","minimum":1}}}}}}}},"x-ai-rules":{"seller_whatsapp":"hidden_until_lead","seller_email":"never_public","create_contact_intent":"http://localhost:3000/api/public/leads"}}