Hey! At ReadMe, we believe a few things about APIs:
1/ π The best APIs are very closely integrated with the documentation
2/ π‘ APIs should be really simple
3/ β APIs don't need to be consumed via code... Slack, Google Sheets, IFTTT, etc
So, we turn this into a product! Our goal with ReadMe Build was to make it as simple as humanly possible to create, deploy and share APIs.
Creating an API is as easy as:
$ npm install api -g
$ api init
$ api deploy
And consuming them is even easier! Here's an (admittedly contrived) example:
https://readme.build/service/math
Let us know what you think!
@mscccc yup! under the hood, it's a really nice wrapper around Lambda. In the future, we'll be more platform agnostic (meaning, we'll deploy to Lambda/Google Functions/etc, and route requests to avoid downtime)
@gkoberger awesome. I think it would be helpful if there were a few more examples in the docs. Such as - connecting to a database / another service (I'm guessing is the same as using lambda).
Other feedback: Deploying through Readme feels "risky" to me. Seems too black box Vs deploying straight to lamba and "owning" it. I do think having Readme be able to auto document existing Lambda functions would be really interesting though.
@mscccc good point on more examples... coming soon!
As for deploying... For people who want control, deploying straight to Lambda is still an option! But for most people, I think they want it to "just work." Kind of like Heroku: you give up control, sure, but in return everything is simple and works well and you just have to worry about writing the code.
For example, here's some features of Build:
* Versioning is done automatically. If a customer uses v1.0.0, and v1.0.1 is released, they customer stays on v1.0.0 (meaning no breaking changes) until it's deprecated.
* Extensive logging, including the ability to attach logs to Issues (so the creator can see what's wrong)
* Rate limiting, API keys, and stuff like that are taken care of
* Consuming is really easy and standardized. We bought "api" package/gem/etc in most languages, so there's no need to worry about URLs. Your APIs just work.
There's a ton more, but those are an overview of some of the cool features you get from Build that wouldn't be possible (without extensive work) if you were deploying directly to Lambda.
We don't see ourselves as a host, but rather a documentation/UI company. If you try consuming an API (for example, https://www.readme.build/service...), you'll see nice of an experience it is!
Based on the FAQs, it sounded like I would be able to create a team and add team members under the free plan. I don't seem to have that ability. It this a known issue or do you have to be on a paid plan to add team members?
ReadMe