Cisco PSIRT just released a beta Swagger YAML file to help you learn, test, and integrate with the Cisco PSIRT openVuln API.
Swagger is a very powerful open source framework for RESTful APIs that was developed by the folks at SmartBear. It provides numerous capabilities that provide interactive documentation, client SDK generation and discoverability. You can use the Swagger Editor to obtain sample code to interact with the Cisco openVuln API in numerous programming languages (including Python, Ruby, Java, etc.).
The beta YAML file can be downloaded from Cisco PSIRT's openVuln GitHub Repository at: https://github.com/CiscoPSIRT/openVulnAPI/
The technical documentation and Swagger 2.0 specs can be accessed at the following URL: https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md
If you are a Swagger expert, please feel free to suggest edits and improvements via GitHub
Keep tuned for further updates and technical references...