[Agendaware-dev-client] XML APIs

[Shane T. <tur...@ya...>]

Just some thoughts regarding APIS.  I've run into a few areas where it
seems the APIs don't make much sense so I wanted to get some feedback.
The main one I wanted to ask about was the RetrieveMailRequest.
It currently looks like this.

<RetrieveMailRequest mailbox="xxx" request_id="xxx" format="header" 
   last_check_time="xxx"/>

Where last_check_time is used to indicate a timestamp of the last time
the client checked for messages.  I was thinking that the server ought
to be able to know what new messages have been delivered but haven't been
requested by the client so I was wondering if maybe we should change
last_check_time to something like "type" where the applicable values
would be "all" meaning to retrieve all messages and "new" meaning to only
give back new messages.   last_check_time just doesn't seem appropriate.

What do you guys think?

Next, I was looking at the client code and it doesn't look like we're in
sync with the APIs with respect to responses and such.  Just as a helper,
when I get the next version of the server out, I'm going to send small
command line programs that can be used to connect to the server and view
the different responses.  I'll also include the exact APIs that the server
understands then you guys can let me know if there's things I need to
change or if you agree with the state of the APIs.

Any problems or questions?

 

__________________________________________________
Do You Yahoo!?
Send FREE Valentine eCards with Yahoo! Greetings!
http://greetings.yahoo.com