{"openapi":"3.1.0","info":{"title":"o agêntico — API de leitura","version":"1.0.0","description":"Eventos de IA e tecnologia agregados de múltiplas fontes. Só entra evento coberto por 2+ veículos editorialmente independentes, contando por dono editorial e não por domínio."},"servers":[{"url":"https://oagentico.com.br"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/eventos":{"get":{"summary":"Lista eventos publicáveis","parameters":[{"name":"desde","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"ate","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"min_fontes","in":"query","schema":{"type":"integer","minimum":2}},{"name":"limite","in":"query","schema":{"type":"integer","maximum":100,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Eventos publicáveis, mais recentes primeiro","content":{"application/json":{"schema":{"type":"object","properties":{"dados":{"type":"array","items":{"$ref":"#/components/schemas/Evento"}},"limite":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer","description":"Total que casa com o filtro, para paginar sem tentativa e erro"}}}}}},"401":{"description":"Credencial inválida ou ausente"},"429":{"description":"Limite de requisições excedido"},"503":{"description":"Indisponível"}}}},"/api/v1/eventos/semana":{"get":{"summary":"Os 20 eventos mais bem apurados dos últimos 7 dias","responses":{"200":{"description":"Eventos publicáveis, mais recentes primeiro","content":{"application/json":{"schema":{"type":"object","properties":{"dados":{"type":"array","items":{"$ref":"#/components/schemas/Evento"}},"limite":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer","description":"Total que casa com o filtro, para paginar sem tentativa e erro"}}}}}},"401":{"description":"Credencial inválida ou ausente"},"429":{"description":"Limite de requisições excedido"},"503":{"description":"Indisponível"}}}},"/api/v1/eventos/{id}":{"get":{"summary":"Evento com síntese, artigos e claims com proveniência","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Evento"},"401":{"description":"Credencial inválida"},"404":{"description":"Não encontrado"},"429":{"description":"Limite excedido"},"503":{"description":"Indisponível"}}}},"/api/v1/entidades":{"get":{"summary":"Índice de entidades","responses":{"200":{"description":"Entidades"},"401":{"description":"Credencial inválida"}}}},"/api/v1/entidades/em-alta":{"get":{"summary":"Entidades mais citadas na janela de 28 dias","responses":{"200":{"description":"Entidades"},"401":{"description":"Credencial inválida"}}}},"/api/v1/entidades/{slug}":{"get":{"summary":"Entidade com os claims em que aparece","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Entidade"},"401":{"description":"Credencial inválida"},"404":{"description":"Não encontrada"}}}},"/api/v1/busca":{"get":{"summary":"Busca full-text em eventos e claims","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Resultados"},"400":{"description":"q ausente"},"401":{"description":"Credencial inválida"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Evento":{"type":"object","properties":{"id":{"type":"integer"},"title":{"type":["string","null"]},"summary":{"type":"string"},"firstEventAt":{"type":"string","format":"date-time"},"articleCount":{"type":"integer"},"independentSources":{"type":"integer","description":"Veículos editorialmente independentes; mínimo 2"},"posterUrl":{"type":["string","null"],"description":"Pôster gerado por nós; é o único material próprio"},"imagem":{"$ref":"#/components/schemas/ImagemDeEvento"}}},"ImagemDeEvento":{"type":["object","null"],"description":"Imagem do artigo da FONTE, não material próprio. Republicar é decisão de quem consome — daí virem juntos o veículo e o artigo.","properties":{"url":{"type":"string"},"fonte":{"type":"string","description":"Domínio do veículo"},"artigoUrl":{"type":"string","description":"Artigo de onde a imagem veio"}}},"ImagemDeEntidade":{"type":["object","null"],"description":"Imagem do Wikimedia com licença auditada. Quando `atribuicao` é true, publicar sem crédito viola a licença — 26 das 117 estão nesse caso (CC BY, CC BY-SA, MIT, MPL, Apache).","properties":{"url":{"type":"string"},"autor":{"type":"string"},"licenca":{"type":"string"},"licencaUrl":{"type":"string"},"fonteUrl":{"type":"string","description":"Página do arquivo no Commons"},"atribuicao":{"type":"boolean","description":"true = crédito obrigatório"}}}}}}