{"id":20753801,"url":"https://github.com/repejota/apiholdit","last_synced_at":"2025-11-09T07:03:02.442Z","repository":{"id":57602100,"uuid":"104007056","full_name":"repejota/apiholdit","owner":"repejota","description":"APIholdit is a drop-in and easy to deploy microservice who exposes an HTTP API you can use to generate placeholder images with a desired text, automatically centered and scaled.","archived":false,"fork":false,"pushed_at":"2017-10-09T11:55:58.000Z","size":187,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-01-18T04:13:45.300Z","etag":null,"topics":["api","apiholdit","design","golang","http","image","microservice","mockup","mvp","placeholder","prototype","rest"],"latest_commit_sha":null,"homepage":"","language":"Go","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/repejota.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}},"created_at":"2017-09-19T00:44:01.000Z","updated_at":"2017-09-25T12:38:37.000Z","dependencies_parsed_at":"2022-09-26T20:00:52.766Z","dependency_job_id":null,"html_url":"https://github.com/repejota/apiholdit","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/repejota%2Fapiholdit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/repejota%2Fapiholdit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/repejota%2Fapiholdit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/repejota%2Fapiholdit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/repejota","download_url":"https://codeload.github.com/repejota/apiholdit/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243057263,"owners_count":20229174,"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","apiholdit","design","golang","http","image","microservice","mockup","mvp","placeholder","prototype","rest"],"created_at":"2024-11-17T09:14:51.716Z","updated_at":"2025-11-09T07:03:02.394Z","avatar_url":"https://github.com/repejota.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# apiholdit\n\n[![License][License-Image]][License-Url]\n[![ReportCard][ReportCard-Image]][ReportCard-Url]\n\n## Table of contents\n\n* [Introduction](https://github.com/repejota/apiholdit#introduction)\n* [User Documentation](https://github.com/repejota/apiholdit#user-documentation)\n\t* [URL Parameters](https://github.com/repejota/apiholdit#url-parameters)\n\t* [Examples](https://github.com/repejota/apiholdit#examples)\n* [Developer Documentation](https://github.com/repejota/apiholdit#developer-documentation)\n* [Continuous Integration](https://github.com/repejota/apiholdit#continuous-integration)\n  * [Tests](https://github.com/repejota/apiholdit#license)\n  * [Coverage](https://github.com/repejota/apiholdit#coverage)\n* [License](https://github.com/repejota/apiholdit#license)\n\n## Introduction\n\nAPIholdit is a drop-in and easy to deploy microservice who exposes an HTTP API you can use to generate placeholder images with a desired text, automatically centered and scaled.\n\nFor example:\n\n![psh screenshot](https://github.com/repejota/apiholdit/raw/develop/placeholder-example-1.png \"placehoder example\")\n\n## User Documentation\n\nThe main entry point for the REST API is the following URL:\n\n```\nhttp://\u003chost\u003e:\u003cport\u003e/i\n```\n\n### URL Parameters\n\nThis URL accept the following parameters:\n\n#### Width\n\n`width` of the placeholder image in pixels. \n\n\u003e By default is `640` pixels.\n\n#### Height\n\n`height` of the placeholder image in pixels. \n\n\u003e By default is `480` pixels.\n\n#### Text\n\n`text` defines the placeholder text that will appear autoscaled and centered on the placeholdwr image.\n\nThis text should be encoded to allow special characters.\n\n\u003e By default is the string `Placeholder`.\n\n#### Background color\n\n`bgcolor` sets the background color to be used to render the placeholder image. \n\n\u003e By default is the color called *Silver* from the [FlatUIColors](http://flatuicolors.com/) color palette. And its code is `#bdc3c7`.\n\n#### Foreground color\n\n`fgcolor` sets the foreground color, or the color being used to draw the text on the placeholder image. \n\n\u003e By default is the color called *Midnight Blue* from the [FlatUIColors](http://flatuicolors.com/) color palette. And its code is `#2c3e50`.\n\n### Examples\n\nHere are a few eamples using the previous defined API:\n\n\n| URL           | Placeholdwer           |\n| ------------- |:-------------:|\n| http://example.com/i?width=320\u0026height=200      | ![psh screenshot](https://github.com/repejota/apiholdit/raw/develop/placeholder-example-2.png \"placehoder example\")  |\n| http://example.com/i?width=320\u0026height=200\u0026text=placeholder-text      | ![psh screenshot](https://github.com/repejota/apiholdit/raw/develop/placeholder-example-3.png \"placehoder example\")      |\n| http://example.com/i?width=320\u0026height=200\u0026text=placeholder-text\u0026bgcolor=c0392b\u0026fgcolor=2980b9 | ![psh screenshot](https://github.com/repejota/apiholdit/raw/develop/placeholder-example-4.png \"placehoder example\")      |\n\n## Developer Documentation\n\n### Deployment\n\nYou can also deploy *APIHoldit* on Heroku with this one click button:\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)\n\n## Continuous integration\n\n### Tests\n\n* Develop: [![CircleCI](https://circleci.com/gh/repejota/apiholdit/tree/develop.svg?style=svg)](https://circleci.com/gh/repejota/apiholdit/tree/develop)\n* Master: [![CircleCI](https://circleci.com/gh/repejota/apiholdit/tree/master.svg?style=svg)](https://circleci.com/gh/repejota/apiholdit/tree/master)\n\n### Coverage\n\n* Develop: [![Coverage Status](https://coveralls.io/repos/github/repejota/apiholdit/badge.svg?branch=develop)](https://coveralls.io/github/repejota/apiholdit?branch=develop)\n* Master: [![Coverage Status](https://coveralls.io/repos/github/repejota/apiholdit/badge.svg?branch=master)](https://coveralls.io/github/repejota/apiholdit?branch=master)\n\n\n## License\n\n(The MIT License)\n\nCopyright (c) 2017 apiholdit Authors.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to\ndeal in the Software without restriction, including without limitation the\nrights to use, copy, modify, merge, publish, distribute, sublicense, and/or\nsell copies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\nFROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\nIN THE SOFTWARE.\n\n[License-Url]: http://opensource.org/licenses/MIT\n[License-Image]: https://img.shields.io/badge/License-MIT-blue.svg\n[ReportCard-Url]: http://goreportcard.com/report/repejota/apiholdit\n[ReportCard-Image]: http://goreportcard.com/badge/github.com/repejota/apiholdit","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frepejota%2Fapiholdit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frepejota%2Fapiholdit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frepejota%2Fapiholdit/lists"}