I've been looking for answers about writing functional specifications for a software for a while now but I can't seem to find an answer to my specific case.
I think I understand the difference between technical and functional specs but it's still hard for me to be clear about that when I write those for a RESTful API. To me a RESTful API is a simple bridge between databases and HTTP-based clients to access data in those databases. When it comes to define the functional specs of such an API I can't seem to be correct and to me the only way is to go into details but I know I'm wrong.
When I try not to go into details there are a lot of repetitions like "Accessing [database table here] informations...." or "Modyfing [database table here] informations...." maybe there will be something like "Authenticate client using OAUTH" but that is it. I'm probably missing something here and right now I feel like I'm completely lost when it comes to write such specs about that kind of API.
Is there a specific way to write them when it comes to such an API or is it just me completely misunderstanding the concept of functional specifications?