{"openapi":"3.1.0","info":{"title":"The Ulutas Medical Journal open API","version":"v1","description":"Read-only, key-free API of published articles. Limit: 60 requests per minute per client; HTTP 429 with Retry-After beyond it."},"externalDocs":{"url":"https://www.ulutasmedicaljournal.com/developers/api"},"servers":[{"url":"https://www.ulutasmedicaljournal.com/api/v1"}],"paths":{"/articles":{"get":{"summary":"List published articles, newest first","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"q","in":"query","description":"Words in the title or subject","schema":{"type":"string","maxLength":200}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"doi","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of articles","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Article"}},"links":{"type":"object"},"meta":{"type":"object"}}}}}},"422":{"description":"Invalid query"},"429":{"description":"Too many requests"}}}},"/articles/{mno}":{"get":{"summary":"One published article by its public number","parameters":[{"name":"mno","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"The article","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Article"}}}}}},"404":{"description":"No published article with this number"},"429":{"description":"Too many requests"}}}}},"components":{"schemas":{"Author":{"type":"object","properties":{"name":{"type":"string"},"given_name":{"type":["string","null"]},"family_name":{"type":["string","null"]},"orcid":{"type":["string","null"]},"affiliation":{"type":["string","null"]}}},"Article":{"type":"object","properties":{"mno":{"type":"integer"},"doi":{"type":["string","null"]},"doi_url":{"type":["string","null"]},"url":{"type":"string"},"pdf_url":{"type":["string","null"]},"title":{"type":"string"},"abstract":{"type":["string","null"]},"article_type":{"type":["string","null"]},"subject":{"type":["string","null"]},"keywords":{"type":"array","items":{"type":"string"}},"language":{"type":["string","null"]},"published_online":{"type":["string","null"],"format":"date"},"year":{"type":["integer","null"]},"online_first":{"type":"boolean"},"volume":{"type":["integer","null"]},"issue":{"type":["integer","null"]},"first_page":{"type":["string","null"]},"last_page":{"type":["string","null"]},"license":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"url":{"type":"string"}}},"authors":{"type":"array","items":{"$ref":"#/components/schemas/Author"}},"journal":{"type":"object"}}}}}}