{"id":31205236,"url":"https://github.com/jy95/spring-fhir-humanizer-api","last_synced_at":"2026-05-09T02:32:10.345Z","repository":{"id":304230381,"uuid":"1018173695","full_name":"jy95/spring-fhir-humanizer-api","owner":"jy95","description":"Spring Boot REST API that converts FHIR Dosage and Timing data into human-readable text, with support for internationalization and configurable output. Includes Swagger UI for interactive exploration.","archived":false,"fork":false,"pushed_at":"2026-04-28T10:49:28.000Z","size":276,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-28T12:31:53.531Z","etag":null,"topics":["dosage","fhir","fhir-api","fhir-parser","fhir-r4","fhir-r5","fhir-server","health","healthcare","hl7-be","hl7-fhir","human-readable","internationalization","narrative-generation","open-source","spring","spring-boot","springboot","springframework","timing"],"latest_commit_sha":null,"homepage":"https://spring-fhir-humanizer-api.onrender.com/swagger-ui/index.html","language":"Java","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/jy95.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-11T18:27:46.000Z","updated_at":"2026-04-28T10:49:26.000Z","dependencies_parsed_at":"2025-12-20T01:02:36.065Z","dependency_job_id":null,"html_url":"https://github.com/jy95/spring-fhir-humanizer-api","commit_stats":null,"previous_names":["jy95/spring-fhir-humanizer-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jy95/spring-fhir-humanizer-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jy95%2Fspring-fhir-humanizer-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jy95%2Fspring-fhir-humanizer-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jy95%2Fspring-fhir-humanizer-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jy95%2Fspring-fhir-humanizer-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jy95","download_url":"https://codeload.github.com/jy95/spring-fhir-humanizer-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jy95%2Fspring-fhir-humanizer-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32804925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["dosage","fhir","fhir-api","fhir-parser","fhir-r4","fhir-r5","fhir-server","health","healthcare","hl7-be","hl7-fhir","human-readable","internationalization","narrative-generation","open-source","spring","spring-boot","springboot","springframework","timing"],"created_at":"2025-09-20T17:20:18.740Z","updated_at":"2026-05-09T02:32:10.328Z","avatar_url":"https://github.com/jy95.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# spring-fhir-humanizer-api [![Codacy Badge](https://app.codacy.com/project/badge/Grade/8ceab67e761147f398a3df72d1e0b741)](https://app.codacy.com/gh/jy95/spring-fhir-humanizer-api/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade) [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/8ceab67e761147f398a3df72d1e0b741)](https://app.codacy.com/gh/jy95/spring-fhir-humanizer-api/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_coverage)\n\n**spring-fhir-humanizer-api** is a Spring Boot REST API powered by [FDS](https://github.com/jy95/fds) that converts \n* FHIR R4 [`Dosage`](https://hl7.org/fhir/R4/dosage.html) and [`Timing`](https://hl7.org/fhir/R4/datatypes.html#timing) elements \n* FHIR R5 [`Dosage`](https://hl7.org/fhir/R5/dosage.html) and [`Timing`](https://hl7.org/fhir/R5/datatypes.html#timing) elements\n\ninto **human-readable text** — in your desired language and with customizable formatting \u0026 more.\n\n## 🚀 Demo\n\n- Swagger UI : https://spring-fhir-humanizer-api.onrender.com/swagger-ui/index.html \n- OpenAPI : https://spring-fhir-humanizer-api.onrender.com/v3/api-docs \n- API : https://spring-fhir-humanizer-api.onrender.com\n\n\u003e ⚠️ **Note:** This instance is hosted on [Render](https://render.com), which puts inactive web services to sleep. The first request after a period of inactivity may take **up to 50 seconds** to respond.\n\n## ✨ Features\n\n- 📝 Converts FHIR **Dosage** and **Timing** elements to plain-language descriptions\n- 🌐 Supports **internationalization** (via locale parameter)\n- ⚙️ Customize display format via options like `displayOrder` and `displaySeparator`\n- 📦 Accepts single or multiple objects\n- 🔍 Includes built-in **Swagger UI** for easy testing and exploration\n- ✂️ Choose output format style :\n  - `SUMMARY` : all results concatenated into a single string\n  - `DETAILED` : generate one string per entry \n\n---\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Java 21+\n- Maven\n\n### Build and Run\n\n```bash\ngit clone https://github.com/your-org/spring-fhir-humanizer-api.git\ncd spring-fhir-humanizer-api\n./mvnw spring-boot:run\n```\n\n## Credits\n\nSpecial thanks to : \n- [The Java library which this webservice uses](https://github.com/jy95/fds)\n- Render.com for the free plan hosting\n\n## Contributors\n\n\u003ca href=\"https://github.com/jy95/spring-fhir-humanizer-api/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=jy95/spring-fhir-humanizer-api\" alt=\"Contributors\" /\u003e\n\u003c/a\u003e\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=jy95/spring-fhir-humanizer-api\u0026type=Date)](https://star-history.com/#jy95/spring-fhir-humanizer-api\u0026Date)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjy95%2Fspring-fhir-humanizer-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjy95%2Fspring-fhir-humanizer-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjy95%2Fspring-fhir-humanizer-api/lists"}