{"id":21489726,"url":"https://github.com/schweizerischebundesbahnen/api-principles","last_synced_at":"2025-10-26T14:05:48.481Z","repository":{"id":38021190,"uuid":"204012778","full_name":"SchweizerischeBundesbahnen/api-principles","owner":"SchweizerischeBundesbahnen","description":"The applicable SBB API Principles","archived":false,"fork":false,"pushed_at":"2024-06-13T07:06:41.000Z","size":713,"stargazers_count":46,"open_issues_count":1,"forks_count":12,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-01-23T20:32:15.001Z","etag":null,"topics":["apis","documentation-site","principles"],"latest_commit_sha":null,"homepage":"https://schweizerischebundesbahnen.github.io/api-principles/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SchweizerischeBundesbahnen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-23T14:20:16.000Z","updated_at":"2024-12-04T13:38:02.000Z","dependencies_parsed_at":"2024-05-29T20:15:10.309Z","dependency_job_id":"bf3df654-70bc-432a-9edf-d678c596a93a","html_url":"https://github.com/SchweizerischeBundesbahnen/api-principles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SchweizerischeBundesbahnen%2Fapi-principles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SchweizerischeBundesbahnen%2Fapi-principles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SchweizerischeBundesbahnen%2Fapi-principles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SchweizerischeBundesbahnen%2Fapi-principles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SchweizerischeBundesbahnen","download_url":"https://codeload.github.com/SchweizerischeBundesbahnen/api-principles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244022670,"owners_count":20385135,"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":["apis","documentation-site","principles"],"created_at":"2024-11-23T14:27:32.237Z","updated_at":"2025-10-26T14:05:48.398Z","avatar_url":"https://github.com/SchweizerischeBundesbahnen.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"![SBB's API Principles](images/API-Principles-Logo.jpg)\n\nThis is the repository for maintaining the SBB's API Principles, as part of the company wide *Integration Architecture* initiative. The principles are subject to constant improvements and are valid for all kind of software projects, independent of the chosen procurement model: reuse, buy, customize, make and also shoring.\n\n*See it in action:* https://SchweizerischeBundesbahnen.github.io/api-principles/\n\n## Repository Structure\n\n#### Documentation\nThe [/docs](/docs) folder contains all the markdown files which are rendered with [jekyll](https://jekyllrb.com). The master branch is automatically being published using [GitHub Pages](https://pages.github.com). For styling, we use [Patrick Marceill](https://github.com/pmarsceill)'s awesome jekyll theme called *[Just-The-Docs](https://github.com/pmarsceill/just-the-docs)*.\n\n#### Versioning\nThe applicable principles are the ones described in the version of the master branch. Minor changes and bugfixes will be merged, using the simple review process by the \"Integration Team\". We maintain Major changes and extensions in a Branch using the name of the next version following the rules of [semantic versioning](https://semver.org/). Releases of new major versions `MUST` be approved by the central IT architecture board and are afterwards merged into the master branch as the new applicable set of principles.\n\nWhen Introducing a new Version, Changes must be updated in the [CHANGELOG.md](/CHANGELOG.md) file.\n\n#### Styling\nCustom styling is overwritten in the [_sass/custom](/_sass/custom) Folder. For further information on customization, read the documentation for [customization](https://pmarsceill.github.io/just-the-docs/docs/customization/).\n\n#### Contributing\nYou are always welcome to [contribute](/CONTRIBUTING.md) to our API Principles by filing a Pull Request (PR).\n\n#### Thank you\n- To Zalando for the publication of their awesome set of RESTful API Guidelines, which is published under the [CC-BY](https://github.com/zalando/restful-api-guidelines/blob/master/LICENSE) (Creative commons Attribution 4.0) license. We’ve learned a lot while reading and adopting them to our needs.\n\n#### License\n[Apache License 2.0](/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschweizerischebundesbahnen%2Fapi-principles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschweizerischebundesbahnen%2Fapi-principles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschweizerischebundesbahnen%2Fapi-principles/lists"}