{"id":19884860,"url":"https://github.com/yohanesokta/hanzsoft-data-api","last_synced_at":"2025-05-02T15:31:12.547Z","repository":{"id":189531674,"uuid":"680841408","full_name":"yohanesokta/hanzsoft-data-api","owner":"yohanesokta","description":":stars: api development database hanzsoft | :globe_with_meridians: Public Api","archived":true,"fork":false,"pushed_at":"2023-12-17T09:32:34.000Z","size":1852,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-01T03:43:11.203Z","etag":null,"topics":["api-rest","example","expressjs"],"latest_commit_sha":null,"homepage":"https://hanzsoft-data-api.vercel.app","language":"JavaScript","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/yohanesokta.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":"2023-08-20T15:25:04.000Z","updated_at":"2025-02-11T05:04:47.000Z","dependencies_parsed_at":"2023-09-23T19:00:33.702Z","dependency_job_id":"7a4cd093-47cf-4fad-a87c-7d7e16c35199","html_url":"https://github.com/yohanesokta/hanzsoft-data-api","commit_stats":null,"previous_names":["yohanesokta/hanzsoft-data-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohanesokta%2Fhanzsoft-data-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohanesokta%2Fhanzsoft-data-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohanesokta%2Fhanzsoft-data-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yohanesokta%2Fhanzsoft-data-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yohanesokta","download_url":"https://codeload.github.com/yohanesokta/hanzsoft-data-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252062774,"owners_count":21688596,"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":["api-rest","example","expressjs"],"created_at":"2024-11-12T17:30:05.656Z","updated_at":"2025-05-02T15:31:12.539Z","avatar_url":"https://github.com/yohanesokta.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp\u003eapi ini difungsikan untuk penggunaan website saya \u003ca href=\"https://github.com/yohanesokta/hanzsoft-websites\"\u003ehanzsoft-websites\u003c/a\u003e\u003c/p\u003e\n\n# :globe_with_meridians: PUBLIC API ( hanzsoft - websites)\n\npenggunaan api ini \"Sebenarnya\" digunakan untuk website saya pribadi , yaitu \u003ca href=\"https://github.com/yohanesokta/hanzsoft-websites\"\u003ehanzsoft-websites\u003c/a\u003e. Namun kalian juga bisa pakai untuk metode belajar atau ingin clone dan modifikasi sendiri untuk sebagai referensi.\n\n![MongoDB](https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white) ![Vercel](https://img.shields.io/badge/vercel-%23000000.svg?style=for-the-badge\u0026logo=vercel\u0026logoColor=white)\n\n![Express.js](https://img.shields.io/badge/express.js-%23404d59.svg?style=for-the-badge\u0026logo=express\u0026logoColor=%2361DAFB) ![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge\u0026logo=node.js\u0026logoColor=white) ![JavaScript](https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge\u0026logo=javascript\u0026logoColor=%23F7DF1E)\n\n## BUILD\n\nbuild sendiri dari data source github \u003cbr\u003e\n\ninstall package telebih dahulu\n\n    $ git clone https://github.com/yohanesokta/hanzsoft-data-api.git\n\n    $ cd hanzsoft-data-api\n\n    $ npm install\n\natau bisa pakai yarn\n\n    $ yarn install\n\n\u003cbr\u003e\n\n    mv .env.example .env\n\nedit _.env_ | isi dengan URI Mongo DB kalian sendiri, bisa bikin di \u003ca href=\"https://cloud.mongodb.com/\"\u003ecloud mongodb\u003c/a\u003e\n| ketentuannya memiliki database utama dan database untuk kategori\n\nrunning\n\n    npm start || npm run dev\n\nselain run sendiri kalian juga bisa menggunakan api yang sudah di deploy\n\n### | Penggunaan\n\n##### :zap: listen on\n\n    https://hanzsoft-data-api.vercel.app/api\n\ngunakan \"/api\"!, jangan hanya menggunakan domainya ok :ok_hand:\n\n## Perubahan v1.2\n\nsemua berubah di versi 1.2 , perubahan pada response api dan perubahan routes menjadi lebih banyak dan mungkin akan mencakup banyak perubahan\n\n## | Method\n\n### GET METHOD\n\nmethod ini akan menampilkan hasil yang kalian berikan pada request\n\nmethod get pada '(url)/api' akan menampilkan semua data tanpa terkecuali\n\n`data pertama ` : data item \u003cbr\u003e\n`data kedua ` : data kategori\n\ncontoh:\n\n### :page_with_curl: GET\n\n    https://hanzsoft-data-api.vercel.app/api\n\nhasil\n\n```json\n{\n    \"status\": {\n        \"code\": 200,\n        \"type\": \"success\"\n    },\n    \"response\": {\n        \"message\": \"\",\n        \"count\": 1,\n        \"data\": {\n            \"items\": [\n                {\n                    \"_id\": \"64f490c3c85850613f5c9d29\",\n                    \"nama\": \"Nama Item\",\n                    \"nama_query\": \"nama yang digunakan untuk query (pencarian)\",\n                    \"kategori\": \"kategori\",\n                    \"description\": \"deskripsi item lebih panjang dari info\",\n                    \"info\": \"mungkin slogan item atau fungsi item\",\n                    \"icon\": \"icon image (link)\",\n                    \"download\": \"download (link)\",\n                    \"ver\": \"version item\",\n                    \"prev\": \"preview image(link)\",\n                    \"req\": \"balum digunakan\"\n                }\n            ],\n            \"kategori\": [\n                {\n                    \"_id\": \"64f36af16d1389ea75b22f89\",\n                    \"jenis\": \"Kategori 1\",\n                    \"image\": \"image (link)\"\n                },\n                {\n                    \"_id\": \"64f36b206d1389ea75b22f8a\",\n                    \"jenis\": \"Kategori 2\",\n                    \"image\": \"image (link)\"\n                }\n            ]\n        }\n    }\n}\n```\n\n## :mag: GET FIND\n\nget find akan menampilkan data sesuai query yang kalian berikan pada url setelah find !\n\npenggunaan\n\nhanzsoft-data-api.vercel.app/api/find/{ query untuk nama software }\n\n**Contoh** :\n\n    https://hanzsoft-data-api.vercel.app/api/find/{ nama software }\n\ncontoh untuk find corel\n\n    https://hanzsoft-data-api.vercel.app/api/find/corel\n\nhasil\n\n```json\n{\n    \"status\": {\n        \"code\": 200,\n        \"type\": \"success\"\n    },\n    \"response\": {\n        \"message\": \"finder data from database by params\",\n        \"count\": 1,\n        \"data\": [\n            {\n                \"_id\": \"64f490c3c85850613f5c9d29\",\n                \"nama\": \"Corel Draw\",\n                \"nama_query\": \"corel draw\",\n                \"kategori\": \"Desain\",\n                \"description\": \"Corel Draw merupakan salah satu perangkat lunak desain grafis berbasis vektor. Perangkat lunak ini biasanya digunakan oleh seorang desainer grafis untuk mengerjakan pekerjaannya memproduksi berbagai hasil desain dengan basis vektor. Berdiri sejak tahun 1985, terhitung sudah lebih dari 90 juta pengguna menggunakan Corel Draw untuk memenuhi kebutuhan desainnya\",\n                \"info\": \"populer editing vektor\",\n                \"icon\": \"https://res.cloudinary.com/dgxbyse13/image/upload/f_auto,q_auto,c_limit,w_200/v1/icon/corel\",\n                \"download\": \"https://www.mediafire.com/file/id5wbcyaqx5fd8t/Corel_Draw_x7_hanzsoft_data.zip/file\",\n                \"ver\": \"x7\",\n                \"prev\": \"https://res.cloudinary.com/dgxbyse13/image/upload/f_auto,q_auto/v1/preview/corel\",\n                \"req\": \"corel.md\"\n            }\n        ]\n    }\n}\n```\n\n## GET (/api/put)\n\nhampir sama seperti (get find) namun sekarang berada di route (url)/api/put/{nama software spesifik}\n\n**Contoh :**\n\n    https://hanzsoft-data-api.vercel.app/api/put/Corel Draw\n\nharus spesifik karena finder dilakukan pada field nama\n\n**Hasil :**\n\n```json\n{\n    \"status\": {\n        \"code\": 200,\n        \"type\": \"success\"\n    },\n    \"response\": {\n        \"message\": \"cari data dengan spesifik\",\n        \"count\": 1,\n        \"data\": [\n            {\n                \"_id\": \"64f490c3c85850613f5c9d29\",\n                \"nama\": \"Corel Draw\",\n                \"nama_query\": \"corel draw\",\n                \"kategori\": \"Desain\",\n                \"description\": \"Corel Draw merupakan salah satu perangkat lunak desain grafis berbasis vektor. Perangkat lunak ini biasanya digunakan oleh seorang desainer grafis untuk mengerjakan pekerjaannya memproduksi berbagai hasil desain dengan basis vektor. Berdiri sejak tahun 1985, terhitung sudah lebih dari 90 juta pengguna menggunakan Corel Draw untuk memenuhi kebutuhan desainnya\",\n                \"info\": \"populer editing vektor\",\n                \"icon\": \"https://res.cloudinary.com/dgxbyse13/image/upload/f_auto,q_auto,c_limit,w_200/v1/icon/corel\",\n                \"download\": \"https://www.mediafire.com/file/id5wbcyaqx5fd8t/Corel_Draw_x7_hanzsoft_data.zip/file\",\n                \"ver\": \"x7\",\n                \"prev\": \"https://res.cloudinary.com/dgxbyse13/image/upload/f_auto,q_auto/v1/preview/corel\",\n                \"req\": \"corel.md\"\n            }\n        ]\n    }\n}\n```\n\n## Penambahan Software Secara Private\n\nGUI Add software telah ditambahkan dalam versi ini di enpoint \u003ca href=\"https://hanzsoft-data-api.vercel.app/api/add\"\u003eAdd Items GUI\u003c/a\u003e\n\npenambahan tersedia pada endpoint\n\n    https://hanzsoft-data-api.vercel.app/api/add/action\n\n_Requires Validation_ kalau mau menambahkan list software\n| request parameter| type |\n|--|--|\n|`nama`| _string_|\n|`kategori`| _string_|\n|`description`| _string_|\n|`info`|_string_ \u0026 **short**|\n|`icon`|_image link_|\n|`download`|**download link**|\n|`ver`|_version number_|\n|`prev`| _image link_|\n|`req`| _system requirements_\n\ninfo akan direplace dengan description kalau tidak di isi\n\n## Project12 ( + ) Apa itu?\n\nDisini saya telah menambahkan property project12 untuk project [EastJavaCulture](https://github.com/yohanesokta/EastJava-Culture)\n\nEndpoint (Get \u0026 Post )\n\n    /project12/Comment\n\nhanya berfungsi sebagai penampung komentar untuk project [EastJavaCulture](https://github.com/yohanesokta/EastJava-Culture)\n\n#### USAGE\n\n| request body | type             |\n| ------------ | ---------------- |\n| `quest`      | _quest key_      |\n| `nama`       | _string nama_    |\n| `date`       | _string tanggal_ |\n| `time`       | _string waktu_   |\n| `field`      | _isi comment_    |\n| `image`      | _isi image_      |\n\nnote : ini hanya dibutuhkan di post request untuk nambah data\n\n## :anchor: Penutup\n\nSaya **YohanesOktanio** mengharapkan kalian sebagai para developer ikut berkontribusi atau pun mengoreksi project saya ini\n\nsebenarnya masih terdapat banyak fungsi namun masih di tahap pengembangan\n\nSaya YohanesOktanio , follow my github \u0026 stay creative :blush:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyohanesokta%2Fhanzsoft-data-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyohanesokta%2Fhanzsoft-data-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyohanesokta%2Fhanzsoft-data-api/lists"}