{"id":19049446,"url":"https://github.com/flothinkspi/cf-api-openapi-poc","last_synced_at":"2026-06-29T00:32:09.059Z","repository":{"id":256408749,"uuid":"852799563","full_name":"FloThinksPi/cf-api-openapi-poc","owner":"FloThinksPi","description":"Proof of Concept - Creating a openapi 3.1.0 spec for the cloudfoundry v3 api","archived":false,"fork":false,"pushed_at":"2025-07-31T09:09:01.000Z","size":95,"stargazers_count":0,"open_issues_count":102,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-12T00:24:06.203Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/FloThinksPi.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-05T12:55:36.000Z","updated_at":"2025-07-31T09:09:05.000Z","dependencies_parsed_at":"2024-09-10T15:30:18.993Z","dependency_job_id":"6933fe88-ed13-452c-a564-de24b647d77f","html_url":"https://github.com/FloThinksPi/cf-api-openapi-poc","commit_stats":null,"previous_names":["flothinkspi/cf-api-openapi-poc"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FloThinksPi/cf-api-openapi-poc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FloThinksPi%2Fcf-api-openapi-poc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FloThinksPi%2Fcf-api-openapi-poc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FloThinksPi%2Fcf-api-openapi-poc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FloThinksPi%2Fcf-api-openapi-poc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FloThinksPi","download_url":"https://codeload.github.com/FloThinksPi/cf-api-openapi-poc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FloThinksPi%2Fcf-api-openapi-poc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34909137,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"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":[],"created_at":"2024-11-08T23:10:55.582Z","updated_at":"2026-06-29T00:32:09.040Z","avatar_url":"https://github.com/FloThinksPi.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CF V3 API OpenAPI Specification Development\n\nThe rendered version can be accessed here: https://flothinkspi.github.io/cf-api-openapi-poc/\n\n# Introduction\n\nIn this project, we are developing an OpenAPI Specification for the Cloud Foundry V3 API.\nThis is done outside the Cloud Foundry Foundation for now, but we aim to contribute the specification back to the foundation once in a usable/mature state.\n\nThe base specification is based on the [Cloud Foundry V3 API documentation](https://v3-apidocs.cloudfoundry.org/). \n\n## Conventions\n\n1. We use lowerCamelCase for field names and operationIds as well as other yaml tokens.\n\n# Development workflows\n\n## Start a local development server\n\nWith below comand you can start a local development server that serves the OpenAPI Specification.\nIt supports hot reloading, so you can make changes to the `openapi.yaml` and see the changes immediately.\n```bash\n  yarn global add @lyra-network/openapi-dev-tool @redocly/cli\n  # Linter\n  redocly lint openapi.yaml \n  # Life reloading webui generated of the openapi.yaml(automatically restart on crash with while loop)\n  while true; do openapi-dev-tool serve -c .openapi-dev-tool.config.json; done\n```\n\n## AI\n\nTo get a good query (to much tokens only usable with gemini-1.5-pro) for ai you can use the following command:\n```bash\n  cat ai/context.txt ai/CFV3Docu.txt openapi.yaml ai/command.txt | pbcopy\n```\n\nThen copy the resulting yaml to `tmp.yaml`\nTo merge snippets of OpenAPI Spec from `tmp.yaml` into `openapi.yaml`, run following command to merge it:\n```bash\necho \"$(yq eval '(.x-components) as $i ireduce({}; setpath($i | path; $i))' openapi.yaml | cat - tmp.yaml)\" \u003e tmp.yaml  \u0026\u0026 yq eval-all -i '. as $item ireduce ({}; . *+ $item)' openapi.yaml tmp.yaml \u0026\u0026  yq e -i '(... | select(type == \"!!seq\")) |= unique' openapi.yaml \u0026\u0026 echo \"\" \u003e tmp.yaml \u0026\u0026 sed -i 's/!!merge //g' openapi.yaml\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflothinkspi%2Fcf-api-openapi-poc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflothinkspi%2Fcf-api-openapi-poc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflothinkspi%2Fcf-api-openapi-poc/lists"}