I remember seeing API documentations of other services in the past where you can do the following:
api.spark.io/v1/all or api.spark.io/v2/all
This will give a programmatic list of endpoints available to the user but i don’t have a strong argument for common use cases.
Maybe some Web developers can help give some feedback? 