{"openapi":"3.1.0","info":{"title":"As Verdadeiras Histórias · API pública","version":"1.0.0","description":"Consulta sem autenticação, somente leitura. Texto oficial, resumos factuais aprovados e ilustrações históricas autorizadas. Patrocínio Bons Filhos.","contact":{"url":"https://verdadeirashistorias.com.br/agentes"}},"servers":[{"url":"https://verdadeirashistorias.com.br"}],"paths":{"/api/public/search":{"get":{"operationId":"searchStories","summary":"Buscar contos no catálogo e no texto oficial","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":180}},{"name":"author","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string","enum":["ready","pending"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["author","original","alpha","principal","views"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/stories/{slug}":{"get":{"operationId":"getStory","summary":"Ler o conto, sua revisão oficial e referências públicas","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"404":{"description":"Conto não encontrado"},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/articles":{"get":{"operationId":"searchArticles","summary":"Buscar análises publicadas com autoria e edições identificadas","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":180}},{"name":"storyId","in":"query","schema":{"type":"string"}},{"name":"author","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/articles/{slug}":{"get":{"operationId":"getArticle","summary":"Ler artigo, fontes e estado das traduções comparadas","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"404":{"description":"Artigo privado ou inexistente"},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/authors":{"get":{"operationId":"listAuthors","summary":"Listar autores públicos e biografias","responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/people":{"get":{"operationId":"listPeople","summary":"Perfis públicos e papéis declarados","parameters":[{"name":"role","in":"query","schema":{"type":"string","enum":["translator","reviewer","producer","illustrator","founder","researcher"]}},{"name":"kind","in":"query","schema":{"type":"string","enum":["contributors","illustrators","translators"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/people/{slug}":{"get":{"operationId":"getPerson","summary":"Perfil público, créditos efetivos e imagens publicadas com atribuição explícita","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"artworkPage","in":"query","schema":{"type":"integer","minimum":1}},{"name":"storyPage","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"404":{"description":"Perfil privado ou inexistente"},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/terms":{"get":{"operationId":"listTerms","summary":"Consultar o índice remissivo","responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}},"/api/public/info":{"get":{"operationId":"getSiteInfo","summary":"Identidade, patrocínio, cobertura e limites","responses":{"200":{"description":"Dados públicos do acervo","content":{"application/json":{"schema":{"type":"object","required":["site"],"properties":{"site":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"object"},"sponsor":{"type":"object"}}}},"additionalProperties":true}}}},"429":{"description":"Limite de 60 requisições por minuto; respeitar Retry-After"},"503":{"description":"Acervo temporariamente indisponível"}}}}},"externalDocs":{"url":"https://verdadeirashistorias.com.br/agentes"}}