API documentation difficult to find and understand

[BRZangado]

Hello! My name is Bruno and in the past few months I worked in a Games BI plataform. In the project, we needed something like Metabase to help in our app development, to help generate some graphics and stuff. Our first choice was Metabase, as we saw a huge potencial, nice looking graphics and a lot of things that could benifit our project, and in order to do this, we had to use the Metabase API, but.....

Difficult to find

We took a long time to find all the location of the API references. One ideia is to to put all the references into the metabase documentation at www.metabase.com/docs/latest/, in the "developer" section for example

Difficult to understand

The API documentation really does not say enought. How can we use that endpoint, example of a post request, what it will return? In other side, post requests requiring MBQL could be more intuitive.. side by side, you know? Maybe some examples would do the trick

I think if the API documentation were more intuitive and complete, Metabase could be one of the greatests business intelligence platform

⬇️ Please click the 👍 reaction instead of leaving a +1 or update? comment

[jeff-bruemmer]

We now have a Learn article that covers an introduction to the API.

https://www.metabase.com/learn/developing-applications/advanced-metabase/metabase-api.html

[Timelessprod]

Any update on this topic ? Any ETA ? Thanks !