API directory

This repo if a collection of metadata descriptions for REST APIs.

Using severals alternative formats for REST metadata.

• Swagger
• RAML
• WADL
• API Blueprint
• ioDocs
• Google Discovery
• Postman Collection Format
• Cenit Collection Format

Find real examples for REST metadata is difficult, here we want provide as much as we can.

Spec

• https://github.com/swagger-api/swagger-spec
• https://github.com/raml-org/raml-spec
• https://github.com/postmanlabs/schemas

Parsers

• https://github.com/postmanlabs/postman-validator
• https://github.com/raml-org/raml-js-parser
• https://github.com/swagger-api/swagger-parser

Converters repos

• https://github.com/lucybot/api-spec-converter
• https://github.com/mulesoft/swagger-to-raml-object
• https://github.com/postmanlabs/swagger2-to-postman
• https://github.com/BulandMalik/RAML2Swagger
• https://github.com/apiaryio/swagger2blueprint
• https://github.com/postmanlabs/raml2postman

##Transform

• https://github.com/postmanlabs/postman-collection-transformer

##Similar projects

• https://github.com/APIs-guru/api-models (Repository for API models in Swagger 2.0 format, many swagger specification were copy from this source.)

TODOS

• Insure that all the examples are valid.
• Add more examples.