{"id":26190303,"url":"https://github.com/maysagoncalves29/petfolioapi","last_synced_at":"2026-04-19T22:34:21.207Z","repository":{"id":278996582,"uuid":"937422024","full_name":"maysagoncalves29/PetfolioAPI","owner":"maysagoncalves29","description":"Repositório de estudos via plataforma da rocketseat. Com o objetivo de aprendizado em C#","archived":false,"fork":false,"pushed_at":"2025-02-24T00:36:16.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-26T10:50:22.828Z","etag":null,"topics":["crud","csharp"],"latest_commit_sha":null,"homepage":"","language":"C#","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/maysagoncalves29.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-02-23T02:21:28.000Z","updated_at":"2025-02-28T18:44:47.000Z","dependencies_parsed_at":"2025-02-23T04:19:01.716Z","dependency_job_id":"417ff078-bdd6-457b-a0f5-0289f3934df0","html_url":"https://github.com/maysagoncalves29/PetfolioAPI","commit_stats":null,"previous_names":["maysagoncalves29/petfolioapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/maysagoncalves29/PetfolioAPI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maysagoncalves29%2FPetfolioAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maysagoncalves29%2FPetfolioAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maysagoncalves29%2FPetfolioAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maysagoncalves29%2FPetfolioAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maysagoncalves29","download_url":"https://codeload.github.com/maysagoncalves29/PetfolioAPI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maysagoncalves29%2FPetfolioAPI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32025774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"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":["crud","csharp"],"created_at":"2025-03-12T00:53:21.733Z","updated_at":"2026-04-19T22:34:21.202Z","avatar_url":"https://github.com/maysagoncalves29.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"--- Repositório para os meus estudos pessoais ----\nDocumentando alguins conceitos que tive dificuldade de entender de início\n\n# PetController - Explicação dos Conceitos\n\nEste repositório apresenta um exemplo de um controller em ASP.NET Core chamado `PetController`. Ele gerencia operações relacionadas a pets, utilizando **REST API**. Aqui estão algumas explicações detalhadas de principais conceitos utilizados no código.\n\n## Definição do Controller\nNo ASP.NET Core, um **Controller** é uma classe que lida com as requisições HTTP e define as regras de como os dados serão processados.\n\n```csharp\n[Route(\"api/[controller]\")]\n[ApiController]\npublic class PetController : ControllerBase\n```\n### Explicação:\n- **[Route(\"api/[controller]\")]**: Define a rota base para as requisições. O `[controller]` será substituído pelo nome da classe (`Pet`), tornando a rota `api/Pet`.\n- **[ApiController]**: Informa que a classe é um controller de API, ativando recursos como validação automática de entradas e respostas HTTP padronizadas.\n- **ControllerBase**: Uma classe base para controllers de API, sem suporte para Views (diferente de `Controller`, que é usado em MVC).\n\n## [ProducesResponseType]\nEste atributo é utilizado para documentar os possíveis retornos de um endpoint.\n\nExemplo no método `GetAll`:\n```csharp\n[ProducesResponseType(typeof(ResponseAllPetJson), StatusCodes.Status200OK)]\n[ProducesResponseType(StatusCodes.Status204NoContent)]\n```\n### Explicação:\n- **200 OK**: Indica sucesso na requisição e retorna uma lista de pets.\n- **204 No Content**: Indica que não há pets cadastrados para retornar.\n\nEsse atributo ajuda no Swagger (documentação da API) e facilita o entendimento do comportamento dos endpoints.\n\n\n## IActionResult\nA interface `IActionResult` é usada para definir o tipo de resposta que um endpoint retorna.\n\nExemplo no método `Delete`:\n```csharp\npublic IActionResult Delete(int id)\n{\n    var useCase = new DeletePetByIdUseCase();\n    useCase.Execute(id);\n    return NoContent();\n}\n```\n### Explicação:\n- `IActionResult` permite retornar diferentes tipos de respostas HTTP, como `Ok()`, `Created()`, `NoContent()`, `BadRequest()`, etc.\n- **NoContent()** (204) indica que a operação foi bem-sucedida, mas não há dados para retornar.\n\nOutros exemplos comuns:\n- `return Ok(data);` → Retorna status 200 com dados.\n- `return BadRequest(errors);` → Retorna status 400 com erros.\n- `return NotFound();` → Retorna status 404 se o recurso não for encontrado.\n\nFique à vontade para contribuir e deixar sugestões! :)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaysagoncalves29%2Fpetfolioapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaysagoncalves29%2Fpetfolioapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaysagoncalves29%2Fpetfolioapi/lists"}