{"id":20338723,"url":"https://github.com/mauroslucios/apirest","last_synced_at":"2026-04-13T16:34:53.269Z","repository":{"id":112491542,"uuid":"439310172","full_name":"mauroslucios/apirest","owner":"mauroslucios","description":"Treinamento Java hateoas","archived":false,"fork":false,"pushed_at":"2022-01-11T14:07:15.000Z","size":40,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-18T06:43:11.053Z","etag":null,"topics":["crud","docker","docker-compose","dto","hateoas","pgadmin4","postgresql","repository","rest-api","services","swagger","swagger-ui"],"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/mauroslucios.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}},"created_at":"2021-12-17T11:29:43.000Z","updated_at":"2022-07-04T20:30:34.000Z","dependencies_parsed_at":"2023-05-15T08:15:48.010Z","dependency_job_id":null,"html_url":"https://github.com/mauroslucios/apirest","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mauroslucios/apirest","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauroslucios%2Fapirest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauroslucios%2Fapirest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauroslucios%2Fapirest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauroslucios%2Fapirest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mauroslucios","download_url":"https://codeload.github.com/mauroslucios/apirest/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauroslucios%2Fapirest/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31761985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","docker","docker-compose","dto","hateoas","pgadmin4","postgresql","repository","rest-api","services","swagger","swagger-ui"],"created_at":"2024-11-14T21:13:59.972Z","updated_at":"2026-04-13T16:34:53.252Z","avatar_url":"https://github.com/mauroslucios.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ApiRest - Modelo de maturidade de Richardson para APIs REST\n\nPara padronizar e facilitar o desenvolvimento de APIs REST, Leonard [Richardson](https://martinfowler.com/articles/richardsonMaturityModel.html) propôs um modelo de maturidade para esse tipo de API, definido em 4 níveis para ser restfull.\n\n## Nível 0\n\nEsse é considerado o nível mais básico e uma API que implementa apenas esse nível não pode ser considerada REST. Nesse nível os nomes dos recursos não seguem qualquer padrão e estão sendo usados apenas para fazer invocação de métodos remotos. Nesse nível usamos o protocolo HTTP para comunicação, mas sem seguir qualquer tipo de regras para implementar os métodos.\n\n```markdown\n| Verbo HTTP | URI            | Operação              |\n| ---------- | -------------- | --------------------- |\n| GET        | /getProdutos   | Buscar todos Produtos |\n| POST       | /salvarProduto | Cria um Produto       |\n```\n\n## Nível 1 — Recursos (Resources)\n\nNesse nível fazemos uso de recursos para modelar a API, para representar cada recurso fazemos uso de substantivos no plural. No exemplo do crud de produto, os recursos seriam identificados pelo substantivo “produtos”.\n\n```markdown\n| Verbo HTTP | URI         | Operação              |\n| ---------- | ----------- | --------------------- |\n| GET        | /produtos   | Buscar todos Produtos |\n| POST       | /produtos   | Cria um Produto       |\n| PUT        | /produtos/1 | Altera um Produto     |\n| DELETE     | /produtos/1 | Apaga um Produto      |\n```\n\n## Nível 2 — Verbos HTTP\n\nComo já foi adiantado no nível 1, o nível 2 se encarrega de garantir que os verbos HTTP sejam usados de forma correta. Os verbos mais utilizados são GET, POST, PUT e DELETE.\nOs métodos GET, PUT e DELETE são considerados idempotente. Um método é considerado idempotente quando uma requisição idêntica pode ser executada várias vezes sem alterar o estado do servidor.\n\n```markdown\n| Verbo HTTP | Função          |\n| ---------- | --------------- |\n| GET        | Recuperar dados |\n| POST       | Salvar dados    |\n| PUT        | Alterar dados   |\n| DELETE     | Excluir dados   |\n```\n\n## Nível 3 — HATEOAS\n\nO nível 3 é sem dúvidas o menos explorado, muitas APIs existentes no mercado não implementam esse nível.\nHATEOAS significa _Hypermedia as the Engine of Application State._ Uma API que implementa esse nível fornece aos seus clientes links que indicarão como poderá ser feita a navegação entre seus recursos. Ou seja, quem for consumir a API precisará saber apenas a rota principal e a resposta dessa requisição terá todas as demais rotas possíveis.\n{\n\"id\": 1,\n\"nome\": \"samsung s8\",\n\"quantidade\": 1.00,\n\"valor\": 2599.00,\n\"links\": [\n{\n\"rel\": \"self\",\n\"href\": \"http://localhost:8080/api/produto/1\"\n}\n\n### Referências\n\nhttps://martinfowler.com/articles/richardsonMaturityModel.html\n\n### Tecnologias\n\n- Jpa\n- swagger\n- dto\n- repository\n- service\n- postgresql\n- postman\n- lombok\n- hateoas\n\n### Para executar o postgresql dockerizado siga os seguintes passos:\n\n#### Instalar docker e docker-compose\n\n- curl -fsSL https://get.docker.com | sh\n- Colocar usuário no grupo docker -\u003e sudo usermod -aG docker $USER\n- Carregar usuário no novo grupo docker - \u003e newgrp docker\n- Instalar docker-compose -\u003e https://docs.docker.com/compose/install/\n\n#### Executar postgresql\n\n- Edite o arquivo docker-compose.yml nos campos senha e usuário do postgres e pgadmin\n- Execute o seguinte comando para subir o container -\u003e docker-compose up -d\n\n#### Acessar o Pgadmin\n\n- Vá em localhost:16543\n- Senha e login que estão no docker-compose.yml\n\n![Captura de tela de 2021-12-23 18-43-56](https://user-images.githubusercontent.com/671694/147294088-649e9c70-b352-4460-ae65-a82b9070e1e7.png)\n\n#### Acessar postgresql pela linha de comando\n\n- docker exec -it nomeOuIdContainer psql -U postgres\n\n![Captura de tela de 2021-12-23 18-42-46](https://user-images.githubusercontent.com/671694/147294119-47a30076-2cf3-4e92-b819-f17167493495.png)\n\n### Requisição postman\n\n![hateoas](https://user-images.githubusercontent.com/671694/147293964-0f834f1b-a362-423b-ba1e-e74d4edeec7d.png)\n\n#### Citação\n\n“A conquista vem quando você cancela as desculpas e transforma adversidade em ação. Todo dia faça algo que te deixe mais perto dos seus objetivos\".\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmauroslucios%2Fapirest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmauroslucios%2Fapirest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmauroslucios%2Fapirest/lists"}