{"id":18790707,"url":"https://github.com/dm-zhuk/goit-node-rest-api","last_synced_at":"2026-05-04T08:41:26.924Z","repository":{"id":248364123,"uuid":"828491243","full_name":"dm-zhuk/goit-node-rest-api","owner":"dm-zhuk","description":"Topics 4-7. #goit-node-rest-api","archived":false,"fork":false,"pushed_at":"2024-08-21T22:46:17.000Z","size":374,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-29T14:52:07.098Z","etag":null,"topics":["dotenv","express","glitch","gravatar-api","jest-tests","nodejs","rest-api"],"latest_commit_sha":null,"homepage":"https://dm-zhuk.github.io/goit-node-rest-api/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dm-zhuk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-07-14T10:11:32.000Z","updated_at":"2024-08-21T22:46:20.000Z","dependencies_parsed_at":"2024-08-21T23:28:31.696Z","dependency_job_id":"e66a9f89-d630-4ee7-8d11-6851114acfbf","html_url":"https://github.com/dm-zhuk/goit-node-rest-api","commit_stats":null,"previous_names":["dm-zhuk/goit-node-rest-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm-zhuk%2Fgoit-node-rest-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm-zhuk%2Fgoit-node-rest-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm-zhuk%2Fgoit-node-rest-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dm-zhuk%2Fgoit-node-rest-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dm-zhuk","download_url":"https://codeload.github.com/dm-zhuk/goit-node-rest-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239712828,"owners_count":19684866,"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","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":["dotenv","express","glitch","gravatar-api","jest-tests","nodejs","rest-api"],"created_at":"2024-11-07T21:13:19.440Z","updated_at":"2025-10-10T08:42:08.216Z","avatar_url":"https://github.com/dm-zhuk.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"#goit-node-rest-api\nНаписати REST API для роботи з колекцією контактів. Для роботи з REST API використовуй [Postman] .\n\nКрок 1\nCтвори репозиторій з назвою goit-node-rest-api і помісти на головну гілку (main) файли з папки src. Завваж: папки src в репозиторії бути не повинно, тебе цікавить лише її вміст.\nСтвори гілку hw02-express з гілки main.\nВстанови модулі командою\nnpm i\n\nКрок 2\nУ файл contactsServices.js (знаходиться в папці services) скопіюй функції з файла contacts.js з домашнього завдання до модуля 1.\n\nКрок 3\nНапиши контролери у файлі contactsControllers.js (знаходиться у папці controllers) з урахуванням наведених нижче вимог.\nREST API повинен підтримувати такі раути:\nGET /api/contacts\n\nВикликає функцію-сервіс getContacts для роботи з json-файлом contacts.json\nПовертає масив всіх контактів в json-форматі зі статусом 200\n\nGET /api/contacts/:id\n\nВикликає функцію-сервіс getOneContact для роботи з json-файлом contacts.json\nЯкщо контакт за id знайдений, повертає об'єкт контакту в json-форматі зі статусом 200\nЯкщо контакт за id не знайдено, повертає json формату {\"message\": \"Not found\"} зі статусом 404\n\nDELETE /api/contacts/:id\n\nВикликає функцію-сервіс removeContact для роботи з json-файлом contacts.json\nЯкщо контакт за id знайдений і видалений, повертає об'єкт видаленого контакту в json-форматі зі статусом 200\nЯкщо контакт за id не знайдено, повертає json формату {\"message\": \"Not found\"} зі статусом 404\n\nPOST /api/contacts\n\nОтримує body в json-форматі з полями {name, email, phone}. Усі поля є обов'язковими - для валідації створи у файлі contactsSchemas.js (знаходиться у папці schemas) схему з використаням пакета joi\nЯкщо в body немає якихось обов'язкових полів (або передані поля мають не валідне значення), повертає json формату {\"message\": error.message} (де error.message - змістовне повідомлення з суттю помилки) зі статусом 400\nЯкщо body валідне, викликає функцію-сервіс createContact для роботи з json-файлом contacts.json, з передачею їй даних з body\nЗа результатом роботи функції повертає новостворений об'єкт з полями {id, name, email, phone} і статусом 201\n\nPUT /api/contacts/:id\n\nОтримує body в json-форматі з будь-яким набором оновлених полів (name, email, phone) (всі поля вимагати в боді як обов'язкові не потрібно: якщо якесь із полів не передане, воно має зберегтись у контакта зі значенням, яке було до оновлення)\nЯкщо запит на оновлення здійснено без передачі в body хоча б одного поля, повертає json формату {\"message\": \"Body must have at least one field\"} зі статусом 400.\nПередані в боді поля мають бути провалідовані - для валідації створи у файлі contactsSchemas.js (знаходиться у папці schemas) схему з використанням пакета joi. Якщо передані поля мають не валідне значення, повертає json формату {\"message\": error.message} (де error.message - змістовне повідомлення з суттю помилки) зі статусом 400\nЯкщо з body все добре, викликає функцію-сервіс updateContact, яку слід створити в файлі contactsServices.js (знаходиться в папці services). Ця функція має приймати id контакта, що підлягає оновленню, та дані з body, і оновити контакт у json-файлі contacts.json\nЗа результатом роботи функції повертає оновлений об'єкт контакту зі статусом 200.\nЯкщо контакт за id не знайдено, повертає json формату {\"message\": \"Not found\"} зі статусом 404\n\nЗверни увагy\n\nВалідацію body можна як здійснювати у контролері, так і створити для цих цілей окрему міддлвару, яка буде викликатись до контролера. Для створення міддлвари можеш скористатись функцією validateBody.js, яку знайдеш у папці helpers\nДля роботи з помилками можна скористатись функцією HttpError.js, яку знайдеш у папці helpers\n\nЯкщо вказані функції використовувати не будеш, видали їх з проєкту перед тим, як надсилатимеш роботу на перевірку ментору\n\nКритерії прийому\nСтворено репозиторій з домашнім завданням\nПосилання на репозиторій (гілку з домашнім завданням) надіслане ментору на перевірку\nКод відповідає технічному завданню (мають бути в точності дотримані, зокрема, вимоги стосовно струкутри body, контенту та статусу відповідей на запити тощо)\nУ коді немає закоментованих ділянок коду\nПроєкт коректно працює з актуальною LTS-версією Node\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdm-zhuk%2Fgoit-node-rest-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdm-zhuk%2Fgoit-node-rest-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdm-zhuk%2Fgoit-node-rest-api/lists"}