{"openapi":"3.0.3","info":{"title":"UFOlens API","version":"1.0.0","description":"唯讀 API：美國政府 UAP/UFO 解密檔案 + UFOlens 之 OCR/翻譯/結構化加值。資料含官方遮蔽內容；請勿還原。須標註來源。"},"servers":[{"url":"https://www.ufolens.com/api/v1"}],"paths":{"/meta":{"get":{"summary":"站台 metadata","responses":{"200":{"description":"OK"}}}},"/docs":{"get":{"summary":"文件清單","parameters":[{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}},{"name":"agency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["PDF","VID","IMG"]}}],"responses":{"200":{"description":"OK"}}}},"/doc/{slug}":{"get":{"summary":"單一文件","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"}}}},"/doc/{slug}/translations/{lang}":{"get":{"summary":"某語言譯文","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/doc/{slug}/ocr":{"get":{"summary":"逐頁 OCR（含正規化 bbox）","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/incidents":{"get":{"summary":"地圖事件（GeoJSON）","parameters":[{"name":"bbox","in":"query","schema":{"type":"string"},"description":"w,s,e,n"},{"name":"from","in":"query","schema":{"type":"string"}},{"name":"to","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/timeline":{"get":{"summary":"時間軸資料","responses":{"200":{"description":"OK"}}}},"/search":{"get":{"summary":"全文檢索","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/entities":{"get":{"summary":"實體查詢","parameters":[{"name":"kind","in":"query","schema":{"type":"string"}},{"name":"value","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}}},"components":{"securitySchemes":{"ApiKeyQuery":{"type":"apiKey","in":"query","name":"key"},"BearerAuth":{"type":"http","scheme":"bearer"}}},"x-tos":{"attribution_required":true,"no_official_impersonation":true,"note":"資料含官方遮蔽內容，請勿還原。依美國法。"}}