APIful Blog We're obsessed with Web APIs


Feb

21

Versioning APIs

  • approaches in versioning APIs
  • semantics of version numbers, vs dates, where to specify
  • implications with deployment models
  • deprecation warnings in API / REST

Read More → Tags:

Feb

21

The New Open

  • APIs are the new open
  • public vs private (open internal vs external)
  • standards are enablers but no longer the same “open” for independence and reduced risk
  • switching costs

Read More → Tags:

Feb

21

What is SaaS? Accoding to Wikipedia, Software as a Service (SaaS) is a software licensing and delivery model in which software is licensed on a subscription basis and is centrally hosted. SaaS service catalog is a portfolio of service offerings an organization provides and is an integral and critical component of the SaaS offering. RESTful APIs offerings in the catalog use open source Swagger framework for API documentation formatted in JSON or YAML. But Swagger has shortcomings. Swagger documentation is just like the user guide you get when you buy a microwave. Consumers want to know what features this microwave provides, but they leave how to use it to whoever is going to use it once it is purchased. To attract consumer to consider your microwave, you need to provide example of how easy you can cook a meal, instead of what the purpose of each button is. A successful SaaS offering is the same, you need to provide demo application, sample usage, or give codesnippets for developers to write an app. You want to let developers do a try and buy. You want consumers to find the right SaaS offering to fit their needs.

Read More → Tags: