{"id":20621990,"url":"https://github.com/bonitasoft/bonita-openapi","last_synced_at":"2025-04-15T12:15:31.459Z","repository":{"id":40271206,"uuid":"299247892","full_name":"bonitasoft/bonita-openapi","owner":"bonitasoft","description":"This repository contains the Bonita OpenAPI specification","archived":false,"fork":false,"pushed_at":"2025-04-02T16:04:36.000Z","size":833,"stargazers_count":7,"open_issues_count":7,"forks_count":1,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-15T12:14:55.830Z","etag":null,"topics":["api","bonita","delivery-github-release","hacktoberfest","http","lifecycle-independent","openapi","published-never","rest-api"],"latest_commit_sha":null,"homepage":"https://api-documentation.bonitasoft.com/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bonitasoft.png","metadata":{"files":{"readme":"README.adoc","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":"2020-09-28T08:52:29.000Z","updated_at":"2025-03-27T15:54:57.000Z","dependencies_parsed_at":"2024-02-07T14:42:35.056Z","dependency_job_id":"b192a592-fb56-485c-9191-e88e7a9e0cf1","html_url":"https://github.com/bonitasoft/bonita-openapi","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonitasoft%2Fbonita-openapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonitasoft%2Fbonita-openapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonitasoft%2Fbonita-openapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bonitasoft%2Fbonita-openapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bonitasoft","download_url":"https://codeload.github.com/bonitasoft/bonita-openapi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249067779,"owners_count":21207396,"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","bonita","delivery-github-release","hacktoberfest","http","lifecycle-independent","openapi","published-never","rest-api"],"created_at":"2024-11-16T12:20:01.517Z","updated_at":"2025-04-15T12:15:31.436Z","avatar_url":"https://github.com/bonitasoft.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"= Bonita OpenAPI specification\n\nimage:https://github.com/bonitasoft/bonita-openapi/workflows/build/badge.svg[Actions Status, link=https://github.com/bonitasoft/bonita-openapi/actions?query=build]\nimage:https://img.shields.io/github/v/release/bonitasoft/bonita-openapi?color=blue\u0026label=Release[GitHub release, link=https://github.com/bonitasoft/bonita-openapi/releases]\nimage:https://img.shields.io/badge/License-GPL%20v2-blue.svg[GPLv2 License, link=LICENSE]\n\nThis project is about describing the Bonita web API in https://swagger.io/specification/[Open API v3] format.\n\nThis single yaml file is to become the single source of truth for the Bonita features accessible through HTTP.\n\nBased on this file, one could generate : documentation, client in different language and/or technology, server side stubs, ...\n\n== Open API v3\n\nThe specification file is written in `yaml` format because multiline support is much better than in `json`\nThe specification has a lot of _description block_ and since it is a _documentation_, it needs to be quite verbose.\n\nThe specification file can be found here: `openapi/openapi.yaml`\n\nWe make use of https://swagger.io/docs/specification/openapi-extensions/[extensions] to add better support for some documentation sites (x-logo, x-codeSamples, ...)\n\nThis repository structure was inspired by https://github.com/Redocly/create-openapi-repo.\n\n== Live Documentation\n\nThe api descriptor file can be used to render documentation sites. Those sites have different rendering and may show different parts of the specification file.\nThat's the reason why it is interesting to test and evaluate different sites and rendering.\n\nYou 'll need to install the https://github.com/redocly/openapi-cli[openapi-cli] to be able to work on the specification.\n\n=== Redoc Preview\n\nA https://github.com/Redocly/redoc[ReDoc] site is available at http://localhost:8080 when you run from project directory\n\n[source,bash]\n----\nnpm start\n----\n\nThis preview is the preferred one when editing the specification.\n\n=== Swagger Preview\n\nThe `docker-compose.yaml` file at the project root starts two sites: a https://swagger.io/tools/swagger-ui/[swagger-ui] site and a Bonita instance to query\n\nTo start the container, just issue the following comment at the project root:\n\n[source,bash]\n----\ndocker-compose up -d\n----\n\nYou should be able to access:\n\n- Bonita: http://bonita.localhost/bonita\n- Swagger UI: http://swagger.localhost\n\nNOTE: You can keep on editing the specification file and just refresh the browser to see the changes.\n\n== Links\n\n*Open API documentation:*\n\nhttps://swagger.io/docs/specification/basic-structure/\n\n*IDE support:*\n\n- intellij: https://www.jetbrains.com/help/idea/openapi.html\n- eclipse: https://marketplace.eclipse.org/category/free-tagging/openapi\n\n*Specification samples:*\n\n- Docker API: https://docs.docker.com/engine/api/v1.40/\n- Discourse API: https://docs.discourse.org/\n- API hub: https://apis.guru/browse-apis/\n- Samples: https://github.com/OAI/OpenAPI-Specification/tree/master/examples/v3.0\n\n*ReDoc*\n\n- https://github.com/Redocly/redoc\n\n== Create a release\n\nA GitHub action is used to automate the link:.github/workflows/release.yml[release workflow].\nThe workflow is triggered by user action and you need to choose the release type (following semver).\n\n:NOTE: This action will automatically update the version (field `version` in `package.json`,`package-lock.json` and `openapi.yaml`)\n\nA GitHub release is created with the `yaml` specification file, the `json` postman collection and the static documentation zip attached.\nRelease note must be filled manually.\n\n:TIP: You can edit the latest release description and click on `Generate releases notes` button to help you to generate a description including the changelog.\n\nNOTE: Use `patch` release if the release content don't include any breaking changes\n\n== After a release\n\nTo deploy your newest release on the documentation site, you need to:\n\n* On https://github.com/bonitasoft/bonita-rest-documentation-site/blob/master/cli/restdoc-site.cfg.json[rest documentation config], add the released version for each compatible Bonita version.\n* Open a PR and asked for a review.\n* Follow updates on your PR, and also to update `openApiLatestVersion:` in `antora.yml` file for each https://github.com/bonitasoft/bonita-doc/[Bonita documentation content] corresponding branches.\n\n== How to contribute\n\nWe would love you to contribute, pull requests are welcome!\nHave a look to link:DEV.md[] guidelines and don't forget to sign our Contributor Licensing Agreements when opening a pull request.\nThis repository uses https://guides.github.com/introduction/flow/[Github flow], so pull requests should target the `master` branch.\n\nWhen you open a pull request, keep in mind to add labels to help the release-note content writing automatically. Labels available are :\n\n|===\n|Release note section| Github PR label\n|New Features 🎉| enhancement\n|Bug fixes 🛠| bug\n|Other Changes| *\n|===\n\n:INFO: If you don't want to see your PR in the release-note, you need to add one of this labels: `dependencies`, `github_actions` or `ignore-for-release-notes`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonitasoft%2Fbonita-openapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbonitasoft%2Fbonita-openapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbonitasoft%2Fbonita-openapi/lists"}