{"openapi":"3.1.0","info":{"title":"FindSardinia public API","version":"1.0.0","description":"Verified destination data, deterministic planning and controlled external-provider handoffs. A handoff is not a booking."},"servers":[{"url":"https://findsardinia.com/api/v1"}],"paths":{"/search":{"get":{"summary":"Search published localized content","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":100}},{"name":"locale","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results"}}}},"/entities/{id}":{"get":{"summary":"Get a stable destination entity with verified facts","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Entity"},"404":{"description":"Not found"}}}},"/plans":{"post":{"summary":"Create a deterministic, explainable travel plan","responses":{"200":{"description":"Plan"},"400":{"description":"Invalid request"}}}},"/handoffs":{"post":{"summary":"Create a signed handoff to an approved external provider; does not book","responses":{"201":{"description":"Handoff created"},"503":{"description":"Provider unavailable"}}}}}}