{"id":13714444,"url":"https://github.com/Asrez/TShirtGoAPI","last_synced_at":"2025-05-07T01:34:08.126Z","repository":{"id":179284841,"uuid":"662499290","full_name":"Asrez/TShirtGoAPI","owner":"Asrez","description":"The T-Shirt Go API is a web-based application programming interface (API) designed to provide access to a wide range of T-shirt-related information and functionalities. The API enables developers to retrieve information about T-shirt categories, brands, sizes, colors, materials, and products.","archived":false,"fork":false,"pushed_at":"2024-04-19T11:47:43.000Z","size":192,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-05-23T04:46:25.859Z","etag":null,"topics":["api","api-go","api-tshirt","api-tshirts","go","go-api","tshirt","tshirt-api","tshirts"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Asrez.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":"2023-07-05T09:10:52.000Z","updated_at":"2024-08-03T00:06:23.942Z","dependencies_parsed_at":null,"dependency_job_id":"b44a0a3e-f109-47b0-a4da-b1d78718fb4f","html_url":"https://github.com/Asrez/TShirtGoAPI","commit_stats":null,"previous_names":["asrez/tshirtgoapi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asrez%2FTShirtGoAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asrez%2FTShirtGoAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asrez%2FTShirtGoAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asrez%2FTShirtGoAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Asrez","download_url":"https://codeload.github.com/Asrez/TShirtGoAPI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224551283,"owners_count":17330117,"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","api-go","api-tshirt","api-tshirts","go","go-api","tshirt","tshirt-api","tshirts"],"created_at":"2024-08-02T23:01:59.666Z","updated_at":"2024-11-14T01:31:16.175Z","avatar_url":"https://github.com/Asrez.png","language":"Go","funding_links":[],"categories":["Repositories"],"sub_categories":[],"readme":"# T-Shirt Go API\n\nThe T-Shirt Go API is a web-based application programming interface (API) designed to provide access to a wide range of T-shirt-related information and functionalities. The API enables developers to retrieve information about T-shirt categories, brands, sizes, colors, materials, and products.\n\n## T-Shirt Key Features\n\n- **T-Shirt Categories:** Retrieve a list of available T-shirt categories, such as men's T-shirts, women's T-shirts, and kids' T-shirts. This helps users navigate and filter T-shirt options effectively.\n- **T-Shirt Brands:** Obtain a list of T-shirt brands, enabling users to identify their preferred brand options.\n- **T-Shirt Sizes:** Retrieve a list of available T-shirt sizes, including small, medium, large, etc. This assists users in selecting the appropriate size for their desired T-shirt.\n- **T-Shirt Colors:** Access a list of available T-shirt colors, allowing users to choose T-shirts that match their preferences.\n- **T-Shirt Materials:** Retrieve information about different T-shirt materials, such as cotton, polyester, and blends. This helps users make informed decisions based on their preferred fabric.\n- **T-Shirt Products:** Obtain a list of available T-shirt products, including details such as the T-shirt's name, category, brand, size, color, material, and price. Users can browse through the available options and make selections based on their preferences.\n\n## API Endpoints\n\n- `GET /categories`: Retrieve a list of available T-shirt categories.\n- `GET /brands`: Retrieve a list of available T-shirt brands.\n- `GET /sizes`: Retrieve a list of available T-shirt sizes.\n- `GET /colors`: Retrieve a list of available T-shirt colors.\n- `GET /materials`: Retrieve a list of available T-shirt materials.\n- `GET /products`: Retrieve a list of available T-shirt products.\n\n## API Examples\n### Get T-shirt Categories:\n\nEndpoint: `GET /categories`\n\nDescription: Retrieve a list of available T-shirt categories.\n\nExample Response:\n\n```json\n[\n  {\n    \"id\": 1,\n    \"name\": \"Men's T-shirts\"\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Women's T-shirts\"\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Kids' T-shirts\"\n  }\n]\n```\n\n### Get T-shirt Brands:\n\nEndpoint: `GET /brands`\n\nDescription: Retrieve a list of available T-shirt brands.\n\nExample Response:\n\n```json\n[\n  {\n    \"id\": 1,\n    \"name\": \"Nike\"\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Adidas\"\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Puma\"\n  }\n]\n```\n\n### Get T-shirt Sizes:\n\nEndpoint: `GET /sizes`\n\nDescription: Retrieve a list of available T-shirt sizes.\n\nExample Response:\n\n```json\n[\n  {\n    \"id\": 1,\n    \"name\": \"Small\"\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Medium\"\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Large\"\n  }\n]\n```\n\n### Get T-shirt Colors:\n\nEndpoint: `GET /colors`\n\nDescription: Retrieve a list of available T-shirt colors.\n\nExample Response:\n\n```json\n[\n  {\n    \"id\": 1,\n    \"name\": \"Red\"\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Blue\"\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Black\"\n  }\n]\n```\n\n### Get T-shirt Materials:\n\nEndpoint: `GET /materials`\n\nDescription: Retrieve a list of available T-shirt materials.\n\nExample Response:\n\n```json\n[\n  {\n    \"id\": 1,\n    \"name\": \"Cotton\"\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Polyester\"\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Blend\"\n  }\n]\n```\n\n### Get T-shirt Products:\n\nEndpoint: `GET /products`\n\nDescription: Retrieve a list of available T-shirt products, with optional filters for brand, color, size, and material.\n\nParameters:\n\n- `brand` (optional): Filter products by brand.\n- `color` (optional) Filter products by color.\n- `size` (optional): Filter products by size.\n- `material` (optional): Filter products by material.\n\nExample Usage:\n\n- `GET /products?brand=Nike`: Retrieve T-shirt products of the brand \"Nike\".\n- `GET /products?color=Red\u0026size=Large`: Retrieve T-shirt products that are red and large in size.\n- `GET /products?brand=Adidas\u0026color=Blue\u0026size=Medium\u0026material=Cotton`: Retrieve T-shirt products of the brand \"Adidas\" that are blue, medium-sized, and made of cotton.\n\nExample Response:\n\n```json\n[\n  {\n    \"id\": 1,\n    \"name\": \"Men's Red T-shirt\",\n    \"category\": \"Men's T-shirts\",\n    \"brand\": \"Nike\",\n    \"size\": \"Large\",\n    \"color\": \"Red\",\n    \"material\": \"Cotton\",\n    \"price\": 29.99\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Women's Blue T-shirt\",\n    \"category\": \"Women's T-shirts\",\n    \"brand\": \"Adidas\",\n    \"size\": \"Medium\",\n    \"color\": \"Blue\",\n    \"material\": \"Polyester\",\n    \"price\": 24.99\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Kids' Black T-shirt\",\n    \"category\": \"Kids' T-shirts\",\n    \"brand\": \"Puma\",\n    \"size\": \"Small\",\n    \"color\": \"Black\",\n    \"material\": \"Blend\",\n    \"price\": 19.99\n  }\n]\n```\n\n## Database PostgreSQL\n\n```sql\n-- Table: Categories\nCREATE TABLE Categories (\n  category_id INT PRIMARY KEY AUTO_INCREMENT,\n  category_name VARCHAR(255)\n);\n\n-- Table: Brands\nCREATE TABLE Brands (\n  brand_id INT PRIMARY KEY AUTO_INCREMENT,\n  brand_name VARCHAR(255)\n);\n\n-- Table: Sizes\nCREATE TABLE Sizes (\n  size_id INT PRIMARY KEY AUTO_INCREMENT,\n  size_name VARCHAR(50)\n);\n\n-- Table: Colors\nCREATE TABLE Colors (\n  color_id INT PRIMARY KEY AUTO_INCREMENT,\n  color_name VARCHAR(50)\n);\n\n-- Table: Materials\nCREATE TABLE Materials (\n  material_id INT PRIMARY KEY AUTO_INCREMENT,\n  material_name VARCHAR(50)\n);\n\n-- Table: Products\nCREATE TABLE Products (\n  product_id INT PRIMARY KEY AUTO_INCREMENT,\n  product_name VARCHAR(255),\n  category_id INT,\n  brand_id INT,\n  size_id INT,\n  color_id INT,\n  material_id INT,\n  price DECIMAL(10, 2),\n  FOREIGN KEY (category_id) REFERENCES Categories(category_id),\n  FOREIGN KEY (brand_id) REFERENCES Brands(brand_id),\n  FOREIGN KEY (size_id) REFERENCES Sizes(size_id),\n  FOREIGN KEY (color_id) REFERENCES Colors(color_id),\n  FOREIGN KEY (material_id) REFERENCES Materials(material_id)\n);\n```\n\nCopyright 2023, Max Base\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAsrez%2FTShirtGoAPI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAsrez%2FTShirtGoAPI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAsrez%2FTShirtGoAPI/lists"}