{"openapi":"3.1.0","info":{"title":"AZRI public knowledge API","version":"1.0.0","description":"Reviewed public content only. Clinical APIs are documented separately in docs\/API.md and require authorization."},"servers":[{"url":"https:\/\/azri.ai\/api\/v1"}],"security":[],"paths":{"\/knowledge":{"get":{"operationId":"listKnowledge","parameters":[{"name":"Accept-Language","in":"header","schema":{"type":"string","enum":["ar","en"]},"description":"Defaults to application locale if omitted."},{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Published entries ordered by publication date and ID, newest first.","content":{"application\/json":{"schema":{"type":"object","required":["data","meta","links"],"properties":{"data":{"type":"array","items":{"$ref":"#\/components\/schemas\/Entry"}},"meta":{"type":"object","properties":{"current_page":{"type":"integer"},"last_page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"}}},"links":{"type":"object","properties":{"next":{"type":["string","null"]},"previous":{"type":["string","null"]}}}}}}}},"422":{"description":"Invalid query parameters","content":{"application\/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded (60 requests\/minute per IP for this route).","content":{"application\/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}},"\/knowledge\/{slug}":{"get":{"operationId":"getKnowledge","parameters":[{"name":"Accept-Language","in":"header","schema":{"type":"string","enum":["ar","en"]},"description":"Defaults to application locale if omitted."},{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"}}],"responses":{"200":{"description":"Published entry","content":{"application\/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#\/components\/schemas\/Entry"}}}}}},"404":{"description":"Entry is missing, not reviewed, or not published","content":{"application\/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"429":{"description":"Rate limit exceeded","content":{"application\/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}},"components":{"schemas":{"Entry":{"type":"object","required":["slug","kind","title","summary","source","reviewed_at","updated_at","url"],"properties":{"slug":{"type":"string"},"kind":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"reviewed_at":{"type":"string"},"updated_at":{"type":"string"},"url":{"type":"string"},"source":{"type":"object","required":["name","url"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}},"source_publication_date":{"type":["string","null"],"description":"Source date text; may contain only a month or year."}}}}}}