[dev] API

[steve]

Hi,

I was through lib/api.php files from different applications, and I wanted 
to get how to use it. For me, it seems that:
- the 'authenticate' service is similar to a 'login' feature
- I didn't find any logout service? (at least for the 'imp' application) 
Should it be called 'clearAuth' ?

I was thinking we could use an application in the following way (let's say 
we work with IMP):
- login with IMP service
-  open a compose page
     from there, we get an Email object
-  we send the e-mail
- logout from IMP service

What do you think?

Thanks

Steve