{"repo":"XeroAPI/Xero-OpenAPI","free":true,"listed":false,"github":"https://github.com/XeroAPI/Xero-OpenAPI","clone":"git clone https://github.com/XeroAPI/Xero-OpenAPI.git","description":"An OpenAPI description of the Xero API","language":"Shell","stars":139,"topics":["openapi","swagger","xero-api"],"license":"MIT","category":"api-integrations-sdks","readme_excerpt":"Xero-OpenAPI An OpenAPI (Swagger) specification for the Xero API with OAuth 2.0 security schema. Description This repository holds the official Xero OpenAPI descriptions. OpenAPI spec 3.0 In Release (used for one or more SDKs) Accounting Identity Bank Feeds Fixed Assets Project Payroll AU Payroll UK Payroll NZ Files Contribution guide Use Conventional Commits for all commits. Why this matters: - We use semantic-release to calculate versions automatically. - Consistent commit formatting keeps versioning predictable and release notes accurate. Versioning rules: - feat: - minor version bump - fix: - patch version bump - ! in the header or BREAKING CHANGE: footer - major version bump Examples: Code Generators We are using OpenAPI generator along with these OAS yaml files to generate our new SDKs. Preview Online There are lots of tools available for viewing and editing OpenAPI descriptions in a nicely formatted way. A popular tool is SwaggerHub - a version of which is hosted here. Once you sign up or login, you can create a new API under your account and import a Xero API spec. Local Node.js If you have Node.js you can use the Swagger UI via an NPM package (it will open a webpage in your default browser): npx -y open-swagger-ui --open ./xero accounting.yaml Docker To view a local file via Docker, run: docker run -p 8080:8080 -e SWAGGER JSON=/local/xero accounting.yaml -v $PWD:/local docker.swagger.io/swaggerapi/swagger-ui To view a hosted file via Docker, run: docker run -p 8080:8","default_branch":null,"files":null,"tree":[],"storefront":"/r/XeroAPI","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/XeroAPI/Xero-OpenAPI/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}