{"openapi":"3.1.0","info":{"title":"Gökbörü Erbil Medya — Public News API","version":"1.0.0","description":"Read-only access to published stories for syndication partners and apps. Responses are cacheable; rate limit 120 requests/minute per client."},"servers":[{"url":"/"}],"paths":{"/api/v1/articles":{"get":{"summary":"List or search published articles","parameters":[{"name":"locale","in":"query","required":true,"schema":{"type":"string","enum":["tr","ku","ar","en"]}},{"name":"q","in":"query","schema":{"type":"string","maxLength":120}},{"name":"category","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Category slug in the requested locale (includes subcategories)"},{"name":"tag","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+$"}},{"name":"author","in":"query","schema":{"type":"string","pattern":"^[a-z0-9-]+$"}},{"name":"type","in":"query","schema":{"type":"string","enum":["news","analysis","opinion","video","gallery","liveblog","sponsored"]}},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"Asia/Baghdad calendar day, inclusive"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"Asia/Baghdad calendar day, inclusive"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"A page of articles","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ArticleSummary"}},"meta":{"$ref":"#/components/schemas/PageMeta"}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/articles/{locale}/{slug}":{"get":{"summary":"Get one published article with its structured body","parameters":[{"name":"locale","in":"path","required":true,"schema":{"type":"string","enum":["tr","ku","ar","en"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"}}],"responses":{"200":{"description":"Article","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ArticleDetail"}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/categories":{"get":{"summary":"Section tree for a locale","parameters":[{"name":"locale","in":"query","required":true,"schema":{"type":"string","enum":["tr","ku","ar","en"]}}],"responses":{"200":{"description":"Categories"},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/breaking":{"get":{"summary":"Active breaking news items for a locale","parameters":[{"name":"locale","in":"query","required":true,"schema":{"type":"string","enum":["tr","ku","ar","en"]}}],"responses":{"200":{"description":"Breaking news"},"400":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}},"PageMeta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"},"totalPages":{"type":"integer"}}},"ArticleSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"storyId":{"type":"string","format":"uuid","description":"Shared by all translations of a story"},"locale":{"type":"string","enum":["tr","ku","ar","en"]},"type":{"type":"string","enum":["news","analysis","opinion","video","gallery","liveblog","sponsored"]},"url":{"type":"string","format":"uri"},"headline":{"type":"string"},"summary":{"type":"string"},"category":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}}},"author":{"type":["object","null"],"properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"image":{"type":["object","null"],"properties":{"url":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"alt":{"type":"string"},"credit":{"type":"string"}}},"publishedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ArticleDetail":{"allOf":[{"$ref":"#/components/schemas/ArticleSummary"},{"type":"object","properties":{"dateline":{"type":["string","null"]},"readingMinutes":{"type":"integer"},"body":{"type":"array","description":"Portable content blocks (paragraph, heading, list, quote, pullquote, image, embed, table, infobox, divider)"},"tags":{"type":"array"},"corrections":{"type":"array"},"translations":{"type":"array"}}}]}}}}