{"id":25864292,"url":"https://github.com/devkayos/nlw-connect","last_synced_at":"2025-10-06T03:46:17.330Z","repository":{"id":278301354,"uuid":"934556684","full_name":"DevKayoS/nlw-connect","owner":"DevKayoS","description":"API REST desenvolvida durante o evento da rocketseat nlw-connect","archived":false,"fork":false,"pushed_at":"2025-02-21T16:38:33.000Z","size":107,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-13T00:45:13.229Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/DevKayoS.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}},"created_at":"2025-02-18T03:07:01.000Z","updated_at":"2025-02-21T16:38:37.000Z","dependencies_parsed_at":null,"dependency_job_id":"e50a6a31-9c1c-4689-8feb-3cf3995487ac","html_url":"https://github.com/DevKayoS/nlw-connect","commit_stats":null,"previous_names":["devkayos/nlw-connect"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DevKayoS/nlw-connect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKayoS%2Fnlw-connect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKayoS%2Fnlw-connect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKayoS%2Fnlw-connect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKayoS%2Fnlw-connect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevKayoS","download_url":"https://codeload.github.com/DevKayoS/nlw-connect/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevKayoS%2Fnlw-connect/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278556187,"owners_count":26006079,"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-06T02:00:05.630Z","response_time":65,"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":[],"created_at":"2025-03-02T00:37:59.808Z","updated_at":"2025-10-06T03:46:17.325Z","avatar_url":"https://github.com/DevKayoS.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NLW Connect API\n\nBem-vindo ao **NLW Connect**, uma API poderosa e simples para gerenciar indicações em eventos. Aumente o engajamento dos participantes com um sistema de ranking dinâmico e rastreamento de cliques!\n\n## 📋 Sobre o Projeto\n\nO **NLW Connect** é uma API desenvolvida para criar um sistema de indicações para eventos. Cada participante recebe um ID único ao se inscrever, que pode ser compartilhado por meio de um link personalizado. Quando novos participantes se inscrevem usando esse link, o usuário original sobe no ranking de indicações. Além disso, a API monitora os cliques nos links, permitindo uma análise completa do alcance de cada participante.\n\n### ✨ Funcionalidades\n- **Inscrição em Eventos**: Gere um ID único ao se inscrever.\n- **Sistema de Indicações**: Aumente seu ranking ao convidar outros participantes.\n- **Rastreamento de Cliques**: Saiba quantas vezes seu link foi acessado.\n- **Ranking Dinâmico**: Veja quem está liderando as indicações em tempo real.\n\n## 🚀 Como Funciona\n\n1. **Inscreva-se**: Crie sua conta ou participe de um evento para receber seu ID único.\n2. **Compartilhe**: Envie seu link personalizado (`exemplo.com/evento?ref=SEU_ID`) para amigos e contatos.\n3. **Indique**: Cada novo participante que usar seu link aumenta sua pontuação no ranking.\n4. **Acompanhe**: Veja quantos cliques seu link recebeu e sua posição no ranking.\n\n## 🛠 Tecnologias Utilizadas\n\n- **[Insira aqui a stack usada, ex: Node.js, Express, MongoDB]**\n- **[Outras ferramentas ou frameworks, se aplicável]**\n\n## 📦 Como Instalar\n\nSiga os passos abaixo para rodar a API localmente:\n\nCertifique-se de configurar o arquivo `.env` com as informações necessárias, como porta, banco de dados e chaves de API.\n\n## 🌐 Endpoints da API\n\nAqui estão alguns dos principais endpoints disponíveis:\n\n| Método | Endpoint                | Descrição                              |\n|--------|-------------------------|----------------------------------------|\n| POST   | `/event/register`       | Registra um novo participante e gera um ID. |\n| GET    | `/event/ranking`        | Retorna o ranking de indicações.       |\n| GET    | `/referral/:id/clicks`  | Mostra o número de cliques no link.    |\n\n*(Adicione mais endpoints conforme a implementação do projeto!)*\n\n## 📈 Exemplo de Uso\n\n1. Um usuário se inscreve e recebe o ID `abc123`.\n2. Ele compartilha o link: `https://seusite.com/evento?ref=abc123`.\n3. Outro usuário clica no link e se inscreve.\n4. O ranking do usuário com ID `abc123` sobe, e o contador de cliques é atualizado.\n\n## 📧 Contato\n\nDesenvolvido por [DevKayoS](https://github.com/DevKayoS).  \nDúvidas ou sugestões? Entre em contato via [insira um e-mail ou rede social].\n\n## 📜 Licença\n\nEste projeto está licenciado sob a [MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevkayos%2Fnlw-connect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevkayos%2Fnlw-connect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevkayos%2Fnlw-connect/lists"}