Yes, the problem is that though IntuiFace is democratizing the ability to interact with REST-based Web Services, the documentation for these services does not have the same motivation. They’re written by and for developers. The results can be helpful - for example. this page on the Twitter API docs site really tries to simplify things - while others are so poorly written that even developers would get tripped up.
Obviously, we can’t solve the problem of bad documentation; it’s out of our hands. What we can do is be more proactive about helping people figure out how to write a query for a given service. To that end, in just a day or two we’ll enhance API Explorer so that badly formatted URLs will cause a window to appear containing the means for contacting Support directly for assistance.
Generally speaking, our Support team will help you figure things out. And, hopefully, through this assistance you’ll improve your own skills.
So don’t be shy about opening a ticket with the Support team or here in the Community when you’re struggling to build a proper request URL.