what functions should the phweet api provide? list, detail, endpoint, accept

[Edward Vielmetti]

a goal, as much as it is, would be to let me set up, accept, and
run a Phweet call all from the command line prompt, without
needing to ever go into a browser.

So far we have a function that does "call setup"; given two
twitter names, it will create a URL that is a call instance.

I can see a few other functions needed to round this out:

0. Get a list of all outstanding calls for my twitter id.
Send in (id,password), get a list of call instances.

1. Given an existing call instance, get information about
the call - eg. if you take the call instance

http://phweet.com/BOuK

there should be some method that returns this as a data
structure, not just as a screen full of text. Note that this
could be combined with the call in (0) to make it a single
round trip.

2. Given an existing call instance, set the call acceptance
point for that call for a user. Something like "I'd like to
take BOuK on this SIP endpoint".

3. Given an existing call instance where you are pending,
start or reject the call. Note again that a single method
could encompass both (2) and (3).

--

(0) assumes a polling infrastructure - you'd ping the server
for available calls, and then accept or reject them. Twitter
does the push version of this, so from a user interface the
function of (0) might actually be done by watching Twitter
instead, either via web, Jabber, IM, SMS etc.

thanks

Ed