{"status":"success","data":{"name":"Ethnos.app Academic Bibliography API","version":"2.0.0","description":"Public RESTful API for academic bibliographic research","environment":"production","timestamp":"2026-06-13T09:48:37.125Z","documentation":{"swagger_ui":"/docs","openapi_spec":"/docs.json"},"system_status":{"database":"Database connected","search_engine":"MariaDB FULLTEXT against works (ft_works_content, ft_works_metadata) / venues (ft_venues_search) / persons (ft_persons_names)","cache":"Redis with 30min TTL","rate_limiting":"Public requests limited to 120/min per IP; a valid X-Access-Key removes the limit","authentication":"No key required for data and metrics endpoints; X-Access-Key still gates /dashboard, /security/* and the internal health probes (/health/readiness, /health/metrics)"},"main_categories":{"search_discovery":{"description":"Search across works, persons, and publications backed by MariaDB FULLTEXT (institutions search disabled for performance)","endpoints":["/search/works","/search/persons","/search/advanced","/search/autocomplete","/search/global"]},"academic_works":{"description":"Publications and citations analysis","endpoints":["/works","/works/{id}","/works/{id}/citations","/works/{id}/references"]},"researchers_authors":{"description":"Researcher profiles and collaboration networks","endpoints":["/persons","/persons/{id}","/persons/{id}/collaborators","/persons/{id}/works"]},"institutions":{"description":"Academic institutions and affiliations","endpoints":["/institutions","/institutions/{id}","/institutions/{id}/works"]},"academic_venues":{"description":"Journals, conferences, and publication venues","endpoints":["/venues","/venues/{id}","/venues/search","/venues/statistics"]},"courses_teaching":{"description":"Academic courses and instructor profiles","endpoints":["/courses","/courses/{id}","/instructors","/instructors/{id}/statistics"]},"bibliography_analysis":{"description":"Academic bibliography and reading analysis","endpoints":["/bibliographies","/bibliographies/analyses"]},"metrics_analytics":{"description":"Research metrics and institutional analytics","endpoints":["/metrics/venues","/metrics/institutions","/metrics/persons","/metrics/collaborations","/dashboard/overview"]}},"data_statistics":{"total_works":null,"total_publications":null,"total_researchers":null,"total_organizations":null,"total_venues":null,"total_courses":null,"collected_at":null},"technical_features":{"search_performance":"MariaDB FULLTEXT indexes on works (ft_works_content + ft_works_metadata) and persons (ft_persons_names) drive search; institutions search disabled for optimal performance","authentication":"Open access: data and metrics endpoints need no key. An optional X-Access-Key (header: x-access-key | x-internal-key | x-api-key) lifts the rate limit and unlocks /dashboard, /security/* and the internal health probes (/health/readiness, /health/metrics).","rate_limits":"Unauthenticated requests: 120/min per IP. No limit when a valid X-Access-Key is supplied.","response_format":"JSON with pagination {page, limit, total, totalPages, hasNext, hasPrev}","cache_ttl":"30 minutes","security":"XSS protection, SQL injection prevention, abuse detection"},"quick_examples":{"search_works":"GET /search/works?q=machine+learning&limit=10","get_work_details":"GET /works/123456","search_authors":"GET /persons?search=silva&limit=5","venue_metrics":"GET /venues/1/statistics","system_health":"GET /health"},"support":{"license":"MIT License","website":"https://ethnos.app","technical_contact":"Bruno Cesar Cunha Cruz - PPGAS/MN/UFRJ"}},"meta":{"request":{"method":"GET","path":"/"}}}