At Tinybird, we have put a lot of effort in ensuring that building API endpoints against large quantities of Data is as simple as possible: just connect your data, write an SQL query and click that “API Endpoint” button and voilà! You now have a secure, real-time analytical API endpoint that developers can consume to build apps.
Building good APIs is not just about how you build them but about making it really easy and convenient to consume.
With that in mind, we have set out to improve the lives of our “Customers’ customers”: the developers that will use the APIs built with Tinybird. Today we introduce our new API endpoints page, where we have done our very best to make it a joy for developers to integrate with each of our endpoints.
How does it work?
- Whenever Tinybird users enable API endpoints they will see a new endpoint page with stats and usage logs for that endpoint. And most importantly, they will be able to “share” that API page with 3rd parties.
- For each endpoint, developers will be able to see general documentation (what is it for) along with all of the possible API parameters.
- Developers will find Open API 3.0 links, so that they can easily exploit them via Postman or Swagger.
- To make it easy to integrate directly from your apps, you will also find snippets for cURL, JavaScript, Python, and other languages.
All the information we use to build these API endpoint pages, from parameters to data types to documentation, is available in OpenAPI 3.0 format. This not only makes integration easier, it also enables you to build your own documentation pages.
See this example integration page, using open data about Coronavirus cases across the world—you are very welcome to use it!
Also, if the security token you are using has access to multiple API endpoints, developers will be able to find the documentation pages for all of them in the same place.
Check out in the video below how to build an API Endpoint out of a large CSV file and how you would go about sharing it with others
Do you want to build kick-ass APIs? Give us a shout.
