{"id":28530106,"url":"https://github.com/includenata/api-viagem","last_synced_at":"2025-10-24T10:22:46.692Z","repository":{"id":297838569,"uuid":"997060929","full_name":"includeNata/api-viagem","owner":"includeNata","description":" Destinify is a modern REST API developed with Spring Boot and Java 21, designed to offer smart travel suggestions based on holidays and enriched city information.","archived":false,"fork":false,"pushed_at":"2025-09-23T21:34:16.000Z","size":158,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-23T23:28:56.354Z","etag":null,"topics":["api","java","java-21","spring","springboot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/includeNata.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-05T22:27:26.000Z","updated_at":"2025-09-16T21:20:51.000Z","dependencies_parsed_at":"2025-08-09T21:09:05.772Z","dependency_job_id":"bcfd08df-62d6-461e-ae0c-c10c0c467858","html_url":"https://github.com/includeNata/api-viagem","commit_stats":null,"previous_names":["includenata/api-viagem"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/includeNata/api-viagem","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeNata%2Fapi-viagem","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeNata%2Fapi-viagem/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeNata%2Fapi-viagem/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeNata%2Fapi-viagem/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/includeNata","download_url":"https://codeload.github.com/includeNata/api-viagem/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeNata%2Fapi-viagem/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018310,"owners_count":26086342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","java","java-21","spring","springboot"],"created_at":"2025-06-09T14:13:24.338Z","updated_at":"2025-10-14T08:32:50.753Z","avatar_url":"https://github.com/includeNata.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Destinify — API de Viagens Inteligentes\n\n## 1. Descrição\n\n**Destinify** é uma API REST moderna desenvolvida com **Spring Boot** e **Java 21**, projetada para oferecer sugestões de viagens inteligentes com base em feriados e informações enriquecidas sobre cidades.\n\nA API utiliza a **IA Generativa do Google Gemini** para enriquecer conteúdo, realiza **web scraping** com **Jsoup** para extrair dados públicos, e emprega um sistema de **cache local** para otimizar o desempenho e reduzir chamadas externas.\n\nSeu propósito é fornecer roteiros de viagem criativos e conteúdos detalhados sobre destinos, por meio de endpoints RESTful bem definidos.\n\n---\n\n## 2. Tecnologias Utilizadas\n\n- **Backend:** Spring Boot 3.5.0  \n- **Linguagem:** Java 21  \n- **IA Generativa:** Google Gemini (google-genai:1.2.0)  \n- **Web Scraping:** Jsoup 1.20.1  \n- **Processamento JSON:** Gson 2.13.0  \n- **Gerenciamento de Dependências:** Apache Maven  \n\n---\n\n## 3. Funcionalidades\n\nA API oferece dois endpoints principais:\n\n- **Geração de Roteiros de Feriados:** Sugere destinos com base em feriados nacionais, otimizando cada sugestão com IA.  \n- **Informações de Cidades:** Extrai e resume conteúdos da Wikipedia e Wikimedia Commons, traduzindo e formatando os dados para entregar um guia turístico rico e personalizado.\n\n---\n\n## 4. Pré-requisitos\n\nAntes de iniciar, certifique-se de ter:\n\n- **JDK 21** (ou superior)  \n- **Apache Maven 3.9+**  \n- **Chave de API do Google Gemini** — disponível no [Google AI Studio](https://aistudio.google.com/)  \n\n---\n\n## 5. Endpoints\n\n### 5.1. Gerar Roteiros de Feriados\n\n- **Método:** `POST`  \n- **URL:** `/api/v1/holiday`  \n- **Descrição:** Recebe a origem, ano e sigla do país. Busca os feriados e utiliza IA para gerar sugestões de viagem. Os resultados são armazenados em cache localmente.\n\n**Corpo da Requisição:**\n```json\n{\n  \"year\": 2025,\n  \"origin\": \"São Paulo\",\n  \"acronym\": \"BR\"\n}\n```\nResposta (200 OK):\nArray JSON com sugestões de destino para cada feriado.\n\n### 5.2. Obter Informações da Cidade\n- **Método:** `POST`\n- - **URL:** `/api/v1/city`  \n- **Descrição:** Busca informações culturais, econômicas, turísticas e de infraestrutura da cidade informada, utilizando scraping e IA para enriquecer o conteúdo.\n\nCorpo da Requisição:\n```json\n{\n  \"city\": \"Paris\",\n  \"touristSpots\": [\"Torre Eiffel\", \"Museu do Louvre\"]\n}\n```\nResposta (200 OK):\nObjeto JSON contendo descrições otimizadas e URLs de imagens dos pontos turísticos.\n\n## 6. Tratamento de Erros\nA API implementa um tratamento global de exceções com @ControllerAdvice, garantindo que todas as respostas de erro sigam um formato padronizado e seguro.\n\nExemplo (404 Not Found):\n```json\n{\n  \"message\": \"A página da Wikipedia para a cidade 'CidadeInexistente123' não foi encontrada.\",\n  \"timestamp\": \"2025-06-26T20:15:45.123456Z\",\n  \"status\": 404,\n  \"path\": \"/api/v1/city\"\n}\n```\n\n## 7. Arquitetura e Boas Práticas\n- Código Limpo e Modular: A estrutura segue princípios SOLID e Domain-Driven Design (DDD), promovendo organização, testes e manutenção eficiente.\n\n- Centralização de Exceções: O uso de @ControllerAdvice evita repetição de lógica de erro nos controllers.\n\n- Exceções Customizadas: Classes como ResourceNotFoundException e GeminiApiException permitem um tratamento de erros preciso e expressivo.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fincludenata%2Fapi-viagem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fincludenata%2Fapi-viagem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fincludenata%2Fapi-viagem/lists"}