{"id":17109266,"url":"https://github.com/kevinoid/swagger-spec-validator","last_synced_at":"2025-10-07T18:56:06.477Z","repository":{"id":15816313,"uuid":"78816259","full_name":"kevinoid/swagger-spec-validator","owner":"kevinoid","description":"Validate an OpenAPI/Swagger API specification using the swagger.io online validator.","archived":false,"fork":false,"pushed_at":"2025-03-24T19:11:48.000Z","size":1069,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T20:24:55.256Z","etag":null,"topics":["nodejs","openapi","swagger","validation"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/kevinoid.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","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":"2017-01-13T04:49:14.000Z","updated_at":"2025-03-24T19:11:46.000Z","dependencies_parsed_at":"2024-01-03T21:26:41.847Z","dependency_job_id":"6b76635d-f28a-44dd-9037-dad99b98d572","html_url":"https://github.com/kevinoid/swagger-spec-validator","commit_stats":{"total_commits":571,"total_committers":4,"mean_commits":142.75,"dds":"0.11383537653239928","last_synced_commit":"260f183dcaff82bc1f77b083980466fe1f716c15"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinoid%2Fswagger-spec-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinoid%2Fswagger-spec-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinoid%2Fswagger-spec-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevinoid%2Fswagger-spec-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevinoid","download_url":"https://codeload.github.com/kevinoid/swagger-spec-validator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248657793,"owners_count":21140842,"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":["nodejs","openapi","swagger","validation"],"created_at":"2024-10-14T16:22:43.276Z","updated_at":"2025-10-07T18:56:01.449Z","avatar_url":"https://github.com/kevinoid.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"OpenAPI/Swagger Specification Validator\n=======================================\n\n[![Build Status](https://img.shields.io/github/actions/workflow/status/kevinoid/swagger-spec-validator/node.js.yml?branch=main\u0026style=flat\u0026label=build)](https://github.com/kevinoid/swagger-spec-validator/actions?query=branch%3Amain)\n[![Coverage](https://img.shields.io/codecov/c/github/kevinoid/swagger-spec-validator/main.svg?style=flat)](https://app.codecov.io/gh/kevinoid/swagger-spec-validator/branch/main)\n[![Dependency Status](https://img.shields.io/librariesio/release/npm/swagger-spec-validator.svg?style=flat)](https://libraries.io/npm/swagger-spec-validator)\n[![Supported Node Version](https://img.shields.io/node/v/swagger-spec-validator.svg?style=flat)](https://www.npmjs.com/package/swagger-spec-validator)\n[![Version on NPM](https://img.shields.io/npm/v/swagger-spec-validator.svg?style=flat)](https://www.npmjs.com/package/swagger-spec-validator)\n\nValidate an OpenAPI/Swagger v2 or v3 API specification against the [OpenAPI\nSpecification](https://github.com/OAI/OpenAPI-Specification) using the\n[swagger.io online validator](https://github.com/swagger-api/validator-badge).\n\nThe validation performed by this module differs from the validation performed\nby [swagger-cli](https://github.com/BigstickCarpet/swagger-cli).\n`swagger-cli` uses\n[swagger-parser](https://github.com/BigstickCarpet/swagger-parser) for\nvalidation, which is a pure JavaScript implementation that can be used\noffline.  This module relies on the validator hosted at swagger.io which uses\nJava-based parser and validator implementations.  Therefore, it requires\nInternet access to use and requires significantly less code to be installed as\na result.\n\n## Introductory Example\n\nTo use `swagger-spec-validator` from the command line, simply invoke it with\nthe specification files to validate as arguments:\n\n```sh\n$ swagger-spec-validator swagger.yaml\n```\n\nIf no arguments are given, the specification will be read from `stdin`.\n\n`swagger-spec-validator` can be used as a library as follows:\n\n```js\nconst swaggerSpecValidator = require('swagger-spec-validator');\nswaggerSpecValidator.validateFile('swagger.yaml')\n  .then((result) =\u003e {\n    if (Object.keys(result).length \u003e 0) {\n      console.log('Invalid.');\n    } else {\n      console.log('Valid!');\n    }\n  })\n  .catch(err =\u003e console.error('Unable to validate: ' + err));\n```\n\n## Installation\n\n[This package](https://www.npmjs.com/package/swagger-spec-validator) can be\ninstalled using [npm](https://www.npmjs.com/), either globally or locally, by\nrunning:\n\n```sh\nnpm install swagger-spec-validator\n```\n\n## Recipes\n\nMore examples can be found in the [test\nspecifications](https://kevinoid.github.io/swagger-spec-validator/spec).\n\n## API Docs\n\nTo use this module as a library, see the [API\nDocumentation](https://kevinoid.github.io/swagger-spec-validator/api).\n\n## Contributing\n\nContributions are appreciated.  Contributors agree to abide by the [Contributor\nCovenant Code of\nConduct](https://www.contributor-covenant.org/version/1/4/code-of-conduct.html).\nIf this is your first time contributing to a Free and Open Source Software\nproject, consider reading [How to Contribute to Open\nSource](https://opensource.guide/how-to-contribute/)\nin the Open Source Guides.\n\nIf the desired change is large, complex, backwards-incompatible, can have\nsignificantly differing implementations, or may not be in scope for this\nproject, opening an issue before writing the code can avoid frustration and\nsave a lot of time and effort.\n\n## License\n\nThis project is available under the terms of the [MIT License](LICENSE.txt).\nSee the [summary at TLDRLegal](https://tldrlegal.com/license/mit-license).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinoid%2Fswagger-spec-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevinoid%2Fswagger-spec-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevinoid%2Fswagger-spec-validator/lists"}