{"id":16461738,"url":"https://github.com/saiht/multiplica-sf","last_synced_at":"2026-04-26T12:32:13.881Z","repository":{"id":51352391,"uuid":"223216327","full_name":"saiht/multiplica-sf","owner":"saiht","description":"Color API","archived":false,"fork":false,"pushed_at":"2022-09-30T20:40:46.000Z","size":332,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-03T11:30:22.003Z","etag":null,"topics":["ansible","api-platform","api-restful","manala","symfony4","vagrant"],"latest_commit_sha":null,"homepage":"","language":"Makefile","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/saiht.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}},"created_at":"2019-11-21T16:25:20.000Z","updated_at":"2020-09-09T11:24:11.000Z","dependencies_parsed_at":"2023-01-18T21:46:03.161Z","dependency_job_id":null,"html_url":"https://github.com/saiht/multiplica-sf","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/saiht/multiplica-sf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiht%2Fmultiplica-sf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiht%2Fmultiplica-sf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiht%2Fmultiplica-sf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiht%2Fmultiplica-sf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saiht","download_url":"https://codeload.github.com/saiht/multiplica-sf/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiht%2Fmultiplica-sf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32297893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"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":["ansible","api-platform","api-restful","manala","symfony4","vagrant"],"created_at":"2024-10-11T11:09:12.485Z","updated_at":"2026-04-26T12:32:13.867Z","avatar_url":"https://github.com/saiht.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"Multiplica color API\n=========================\n\nMade with ❤️, by me, with the following technologies:\n- [Manala](http://www.manala.io/)\n- [Symfony](https://symfony.com)\n- [Api Platform](https://api-platform.com/)\n\n### Description\n\nThis project allows designers to have access to colors, in order to integrate them into their graphic charters.\n\n\n## Installation\n\n### Requirements\n\n|Tool|Version|Installation/Download|\n|-----|-----|-----|\n|VirtualBox|5.1.18+|https://www.virtualbox.org/wiki/Downloads|\n|Vagrant|1.8.7|https://releases.hashicorp.com/vagrant/|\n|Landrush|1.2.0+|`$ vagrant plugin install landrush`|\n\nFox OS X, vagrant version 1.8.7 might require the following patch:\n\n```bash\nsudo rm -f /opt/vagrant/embedded/bin/curl\n```\n\n### Getting started\n    \nTo install the project the first time and boot the VM, execute:\n```bash\nmake setup # or vagrant up\n```\n\nNow you can access the API docs by browsing to http://multiplica.test/api/docs.\n\nIf you don't want to use the vm, you can simply install the project with:\n```bash\ncomposer install\n```\nThen, maybe you need some `colors` in your database?\nFor that, you need to update the variable `DATABASE_URL` in the `.env` file, and execute:\n```bash\ncomposer do-work\n```\nwhich will create the database, creating schema, and importing the `colors.csv` data.\nSee more about the command in ### Miscellaneous section below.\n\nHow to serve the application out of the vm:\n```bash\nphp -S localhost:8000 -t public\n```\n\n### Endpoints\n\nOn this endpoint you can use the provided sandbox to experiment all routes:\n\n| Name                        |Method    |   Path                       |\n|-----------------------------|----------|------------------------------|\n| api_doc                     |ANY       | /api/docs.{_format}          |\n| api_colors_get_collection   |GET       | /api/colors                  |\n| api_colors_post_collection  |POST      | /api/colors                  |\n| api_colors_get_item         |GET       | /api/colors/{id}             |\n| api_colors_patch_item       |PATCH     | /api/colors/{id}             |\n| api_colors_put_item         |PUT       | /api/colors/{id}             |\n| api_colors_delete_item      |DELETE    | /api/colors/{id}             |\n\nThe retrieved contents by the Color API corresponds to asked `Content-Type` header.\nAllowed types are:\n- `application/json`\n- `application/xml`\n- `application/html`\n\nHere is an example of color list XML response:\n```xml\n\u003c?xml version=\"1.0\"?\u003e\n\u003cresponse\u003e\n  \u003citem key=\"0\"\u003e\n    \u003cid\u003e1\u003c/id\u003e\n    \u003cname\u003ecerulean\u003c/name\u003e\n    \u003ccolor\u003e#98B2D1\u003c/color\u003e\n  \u003c/item\u003e\n  \u003citem key=\"1\"\u003e\n    \u003cid\u003e2\u003c/id\u003e\n    \u003cname\u003efuchsia rose\u003c/name\u003e\n    \u003ccolor\u003e#C74375\u003c/color\u003e\n  \u003c/item\u003e\n  \u003citem key=\"2\"\u003e\n    \u003cid\u003e3\u003c/id\u003e\n    \u003cname\u003etrue red\u003c/name\u003e\n    \u003ccolor\u003e#BF1932\u003c/color\u003e\n  \u003c/item\u003e\n    . . .\n\u003c/response\u003e\n```\nThe listing result can also be paginate by adding the `page` query parameter, like here:\nhttp://multiplica.test/api/colors?page=1 will render the first 20 colors.\n\n\n**Note:**\n\nFor the POST route (api_colors_post_collection), the new color entity must pass those rules:\n- name: not blank (null or empty string), 3 characters min\n- color: '#' character + the color code (examples: #fff, #FFF or #0101DF\")\n- pantone_value: not blank, 3 characters min\n- year: not blank, 1900-2099 range\n\n### Miscellaneous\n\nIf you want to see the format of the Color API, you can use:\n\n```bash\nmake api-export\n```\n\nIf you have more colors entries you want to import, you can run the new command:\n```bash\nvagrant ssh -- \"cd /srv/app \u0026\u0026 php bin/console app:seed-colors \u003cfile\u003e\"\n```\n(Or directly `bin/console app:seed-colors \u003cfile\u003e`if you don't want to use serve the application inside the vm)\n\nDon't forget to replace `\u003cfile\u003e` by the path of your csv file.\n\nNote that you csv file MUST have the `,` delimiter, and those columns:\n\n|id|name|year|color|pantone_value|\n|--|----|----|-----|-------------|\n\n\n### Destroy vms\n\nTo destroy entirely the vms, you can use:\n\n```bash\nmake force-destroy\n```\n\n:warning: it will also drop the project database!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaiht%2Fmultiplica-sf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaiht%2Fmultiplica-sf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaiht%2Fmultiplica-sf/lists"}