add a very basic specification for an API to the documentation. next step would be implementation. see: subugoe/ahiqar/ahiqar#26