{"openapi":"3.1.0","info":{"title":"foodsafety.tw public data API","version":"2026-08-05T07:31:25.313Z","description":"Official announcements and attributed supplier evidence. Absence from the dataset does not mean unaffected.","license":{"name":"CC BY 4.0","identifier":"CC-BY-4.0"}},"servers":[{"url":"https://foodsafety.tw"}],"components":{"schemas":{"CoverageCounts":{"type":"object","description":"For every coverage count, published is at most entered and withheld equals entered minus published.","additionalProperties":false,"required":["entered","published","withheld"],"properties":{"entered":{"type":"integer","minimum":0},"published":{"type":"integer","minimum":0},"withheld":{"type":"integer","minimum":0}}},"ProductRegisterCoverage":{"type":"object","description":"Each total equals the sum of the corresponding byStatus values. total.published also equals the published products manifest count.","additionalProperties":false,"required":["total","byStatus"],"properties":{"total":{"$ref":"#/components/schemas/CoverageCounts"},"byStatus":{"type":"object","additionalProperties":false,"required":["official-recall","precautionary-hold","pending","officially-relisted","unaffected-attested"],"properties":{"official-recall":{"$ref":"#/components/schemas/CoverageCounts"},"precautionary-hold":{"$ref":"#/components/schemas/CoverageCounts"},"pending":{"$ref":"#/components/schemas/CoverageCounts"},"officially-relisted":{"$ref":"#/components/schemas/CoverageCounts"},"unaffected-attested":{"$ref":"#/components/schemas/CoverageCounts"}}}}},"PublicMeta":{"type":"object","additionalProperties":false,"required":["releaseId","dataVersion","asOf","license","disclaimer"],"properties":{"releaseId":{"type":"string"},"dataVersion":{"type":"string","format":"date-time"},"asOf":{"type":"string","format":"date-time"},"license":{"type":"string"},"disclaimer":{"type":"string"},"coverage":{"$ref":"#/components/schemas/ProductRegisterCoverage"}}}}},"paths":{"/api/v1/health.json":{"get":{"summary":"Check the current public release and primary manifests","responses":{"200":{"description":"Public API is healthy","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status","service","summary","version","dataVersion","counts"],"properties":{"status":{"type":"string","const":"ok"},"service":{"type":"string"},"summary":{"type":"string"},"version":{"type":"string"},"dataVersion":{"type":"string","format":"date-time"},"counts":{"type":"object","additionalProperties":false,"required":["events","products"],"properties":{"events":{"type":"integer","minimum":0},"products":{"type":"integer","minimum":0}}}}}}}},"503":{"description":"Published release is unavailable"}}}},"/api/v1/events.json":{"get":{"summary":"List incidents","responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}}}}},"/api/v1/events/{id}/products.json":{"get":{"summary":"List public products for an incident","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Products","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}},"404":{"description":"Unknown event"}}}},"/api/v1/events/{id}/products.csv":{"get":{"summary":"Download public incident products as Excel-compatible CSV","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"CSV dataset"}}}},"/api/v1/suppliers.json":{"get":{"summary":"List suppliers","responses":{"200":{"description":"Suppliers","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}}}}},"/api/v1/documents.json":{"get":{"summary":"List evidence documents","responses":{"200":{"description":"Documents","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}}}}},"/api/v1/changelog.json":{"get":{"summary":"List changes","responses":{"200":{"description":"Changelog","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}}}}},"/api/v1/search-index.json":{"get":{"summary":"Download compact client index","responses":{"200":{"description":"Index","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}}}}},"/api/v1/search":{"get":{"summary":"Search products, brands, suppliers, batches, and barcodes","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"supplier","in":"query","schema":{"type":"string"}},{"name":"updatedSince","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"string"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","required":["meta","data"],"properties":{"meta":{"$ref":"#/components/schemas/PublicMeta"},"data":{}}}}}}}}}},"x-foodsafety-meta":{"releaseId":"20260805-f337774f3c58","dataVersion":"2026-08-05T07:31:25.313Z","asOf":"2026-08-05T07:31:25.313Z","license":"CC BY 4.0","attribution":"食安現況 foodsafety.tw — 四海食品原料有限公司 (HISUNFOODS)","publisher":{"name":"四海食品原料有限公司 (HISUNFOODS)","url":"https://hisunfoods.com/zh-tw/"},"disclaimer":"本站彙整官方公告與供應商提供的佐證，不自行判定產品安全；查無資料，仍可能受影響。","coverage":{"total":{"entered":284,"published":27,"withheld":257},"byStatus":{"official-recall":{"entered":4,"published":3,"withheld":1},"precautionary-hold":{"entered":5,"published":2,"withheld":3},"pending":{"entered":253,"published":0,"withheld":253},"officially-relisted":{"entered":0,"published":0,"withheld":0},"unaffected-attested":{"entered":22,"published":22,"withheld":0}}}}}