basic specification

add a very basic specification for an API to the documentation.

next step would be implementation.

see: subugoe/ahiqar/ahiqar#26