We need to define a consistent API and have documentation ready, so other implementations can exist.

https://swagger.io comes to mind.