This repository was archived by the owner on Nov 6, 2025. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
API Tooling
Bryan Barnard edited this page Jul 30, 2015
·
7 revisions
Josh Kalis (@kalisjoshua)
Chris Busse (@busse) ... (add your names here, people!)
Jason Hammond (@hammondjm)
Bryan Barnard (@nardbard)
- RAML, Swagger, UML...
- For documentation: Annotations in Code? []Y []N
- RAML linter... RAMLint ideally setup so that build can pass/fail based on that
- BDD - Mocha & Chai - descriptive JS with dot notation for natural test writing
- Read More: Steve Klabnik (@steveklabnik) blog post(?) from last year on testing
- Using single page app to pull GHE repos and audit their structure and files to make sure projects are meeting internal standards - this is a tool Josh expects to invest in more
- Make the output easily viewable so that devs can work more proactively
- How much you can automate vs. how much is human behavior from their development practices - how much can you automate quality assurance?
- ...(Busse was talking so didn't take his own notes here)
- Top down: API Blueprint / Dredd - put in JSON schema and validate, setup your environment (things you can't do in documentation)
- (Lots of discussion about dredd)
- What about automated testing for hypermedia APIs?
- More robust libraries for client-side serialization would be nice
- Service Virtualization (SV) - used to mock out services that you know
- Montebank - may have some timeout testing that others don't have
- APIary as a Saas can help w/ SV
- SV used for testing if a public website - how would it behave if the vendor's site went down
- Client Tools...
- Ted - curious to know about seeing library of available services
- Developer portals for discoverability
- Mulesoft Gateway & Portal
- Discussion of different API Gateway providers
- Has anyone tried out the AWS Gateway? - Discussion of using it for non-AWS hosted APIs vs. not
- Mashing up external data sources with your own? Mashape
EOF
- From Lorinda Brandon: I wasn't at this session but SmartBear also has an API Virtualization tool called ServiceV. Desktop app that does mocking and server-side simulations. Can ingest Swagger definitions, as well as RAML/WADL/WSDL/Blueprint and generate virtual APIs.