README.md

Design First Workflow

first create a spec with editor or online tools

Possible Worklow

1. Design first in editor
2. generate mock server
3. generate client
4. create integration tests
5. implement API
6. test API with integration tests

###Example specs:

• swagger
• raml
• apiblueprint

##helpful tools (incomplete list) ####mock server

• api-mock – usage : api-mock blueprint.md
• drakov – usage : drakov -f blueprint.md
• raml-mockup – usage raml-mockup api.raml

####verify endpoints

• abao – usage : abao api.raml http://localhost:8080/
• dredd – usage : dredd blueprint.md http://localhost:8080

####codegen

• raml to jaxrs – creates jersey interfaces – usage mvn generate-sources
• swagger-codegen – creates server/client code – usage mvn swagger-codegen:generate

Noteworthy

• [https://github.com/playround/rspec_api_blueprint](blueprint from rspec)
• [https://github.com/pixelfusion/blueman](blueprint to postman)