Cloud services which helps..
Hey there! I normally work on full stack projects and while doing so, documentation is anyway required. I have created documentation like API spec, test case documents for APIs and it has taken quite some time creating them.
Today, let me share two tools with you that saved lot of my time at least. Hoping that it does for you too!
Problem 1 – Creating API Spec Swagger 2.0
Now, we all have worked on postman creating our test cases for all scenarios and have added few changes to the request and response. Now, it might be that you followed this already but I didn’t know at this time. So I created by Swagger documentation upfront and then wrote my postman test cases. Now at the end of my development, I was left with a difference between the Swagger API documentation and the test cases. I had like ~200 at my hand. It was quite a task.
Google saved the day by taking me to an amazing tool – APIMatic.
API Matic
As the site puts it “Developer Experience Platform” – for your Public/Private/Internal APIs. It does what it says it does. I used one of the service only “API Transformation”. I just uploaded my postman script (version didn’t even matter) and selected that I wanted Swagger 2.0 specification. Ta-da.. I got a complete Swagger documentation with all information populated from my postman script!
Phew! It did save me lot of time and the interface was really easy! Give it a try! Let me know what tool you use if this APIMatic.
Problem 2 – Mocking Rest and SOAP
Another problem I faced during one of my project is to resolve dependencies on other applications and thier end points. Now I know, that there are lot of applications offline/online that fits the problem domain of API mocking. I have tried few of them but this I like the most – Mockable.
Mockable.io
As they quote – “The Fastest way to mock your API”. Again it fits. I was able to create the APIs in like <1 min for a JSON based rest API. Now what I think is the most important piece of the service is the way it handles mocks. I like the way that it was able to give me a base domain and from there I can provide my own paths and endpoints which can totally match my application integration. This is a true mock of the end points. The only thing I needed to change was the endpoint while switching from mock to actual and I was good to go.
I did ease my development and integration testing cycle time. Hope it help you too!
What are your cloud tools you use in this space.