{"id":15616279,"url":"https://github.com/soartec-lab/openapi-devtools","last_synced_at":"2026-05-16T07:08:40.445Z","repository":{"id":126105170,"uuid":"354060973","full_name":"soartec-lab/openapi-devtools","owner":"soartec-lab","description":"Devtools and sample specification for OpenAPI v3","archived":false,"fork":false,"pushed_at":"2023-09-28T23:54:08.000Z","size":68,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-09T11:59:21.940Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dart","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/soartec-lab.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":"2021-04-02T15:36:54.000Z","updated_at":"2024-03-01T05:29:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"b859ea4a-e02a-4a1f-83ea-9c200be3121b","html_url":"https://github.com/soartec-lab/openapi-devtools","commit_stats":{"total_commits":21,"total_committers":1,"mean_commits":21.0,"dds":0.0,"last_synced_commit":"5b3343478d2e986975d1122bd88a06130b7dd2c0"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/soartec-lab/openapi-devtools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soartec-lab%2Fopenapi-devtools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soartec-lab%2Fopenapi-devtools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soartec-lab%2Fopenapi-devtools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soartec-lab%2Fopenapi-devtools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soartec-lab","download_url":"https://codeload.github.com/soartec-lab/openapi-devtools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soartec-lab%2Fopenapi-devtools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33093700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2024-10-03T07:05:47.580Z","updated_at":"2026-05-16T07:08:40.426Z","avatar_url":"https://github.com/soartec-lab.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openapi-devtools\nDevtools and sample specification for OpenAPI v3\n\n## Setup\n\n```\n$ git clone git@github.com:soartec-lab/openapi-devtools.git\n$ docker-compose build\n```\n\n## Usage\n\n### Use `swagger-ui`\n\n`swagger-ui` is hosted on`localhost` port 8080 of `docker-compose`.\n\n```\n$ docker-compose up\n$ open http://localhost:8080\n```\n\n### Use `swagger-editor`\n\n`swagger-editor` is hosted on`localhost` port 8081 of `docker-compose`.\n\n```\n$ docker-compose up\n$ open http://localhost:8081\n```\n\n### Start mock server with prism\n\nSince prism cannot parse openapi `$ref`, use`openapi-generator` to combine the split YAML files into one schema.\n\n```\n$ docker-compose run --rm openapi-generator generate -i workspace/openapi.yml -g openapi-yaml -o workspace/generated\n```\n\n`prism` is hosted on`localhost` port 8082 of `docker-compose`.\nIf you execute the above command and send a request to the mock server after the schema file is output to the `generated` directory,` prism` will interpret the request and return a sample response.\n\n```\n$ curl -X GET \"http://localhost:8082/users?id=1\" -H \"accept: application/json\"\n#=\u003e {\"user_id\":\"1234567\"}\n```\n\n## Directory structure\n\n```\n$ tree\n.\n├── LICENSE\n├── README.md\n├── docker-compose.yml\n├── generated\n│   ├── README.md\n│   └── openapi\n│       └── openapi.yaml\n├── openapi.yml\n└── resources\n    ├── components\n    │   └── schemas\n    │       └── errors.yml\n    └── paths\n        └── users.yml\n```\n\n### generated\n`openapi-generator` The output directory of the integrated YAML file.\n`prism` refers to `generated/openapi/openapi.yaml`.\n\n### openapi.yml\nIf you want to add a new path, add the definition to this file.\n`swagger-ui` and `swagger-editor` refer to this file.\n\n### resources\nAPI resource definitions are stored in `paths`, and commonly used components are stored in `components`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoartec-lab%2Fopenapi-devtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoartec-lab%2Fopenapi-devtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoartec-lab%2Fopenapi-devtools/lists"}