API Events

[Akarin]

So if I have read the API correctly, there is no event model that
triggers client callback urls except activate, deactivate and the
configure iframe and I have to poll to Ring feed to determine that
things have happened?

[Sam Aparicio]

Hi Akarin, indeed correct.

But there are "feed" decorations on the resources that will allow you to get the delta of changes since the last time you checked.

Eg: HTTP GET http://api.ringio.com/feeds/users/{userId}/contacts?since={timestamp}

Will get you 3 lists, the contacts created, updated and deleted for that user since the timestamp. You can obtain a valid timestamp simply by calling any of the GET methods of a resource.

The API is still in its infancy, so feedback is more than welcome!

Sam

[ARW]

Basically we are using many other SaaS companies with APis for
integration and some would be excellent for Ringio and I would like to
develop interfacing for my company use and also possibly for other
users.

The short Wish List:

1) Right now you have an API for non-ui integration focused on CRM
synchronization. To support plugin-in integration you should have an
area for ui style plugins to be launched in a new AIR window or open a
new tab in your app. There are so many more complimentary cloud
based tools out there that could kick up the usefulness of Ringio.
For example if you look at Salesforce or SugarCRM implementation you
can directly access plugins from their dashboard.

2) I would like to see an event model where callback urls, IF
defined/registered by the plugin for that event, are fired
synchronously instead of a polled feed. For example when an incoming
call is answered, then answer_event is called for all registered
plugins, then each plugin's url is fired with the correct plugin
requested variables. So Activate and Deactivate would be just two of
say 10 events that a plugin could register for notification.

3) I noticed the API is not encrypted. Is there SSL api access?

[Akarin]

One current real world example with Ringio for my #1 above would be
with the current fax system you are using. Joomla has a Wrapper
component to wrap any URL within its framework. Yeah, since the
target is not in the same domain then you cannot dynamically size the
iframe which stinks but at least you can pull in pages into the site.
A UI plugin that lets me iframe another site for easy access... say
the site you are using for the fax solution... then all of my
communications apps will be in one location and readily available. Or
I could frame a frequently referenced government site that had a
database of frequently looked up codes and information and have all
that on tabs or launchable from the desktop app.

for #2 if I knew who a caller was and the group upon answering, I
could possibly pop open any one of the numerous cloud storage systems
out there to have immediate access to advertising collateral or any
other pertinent documents.

[Sam Aparicio]

This is very insightful feedback! Thanks for sending.

[Sam Aparicio]

Also, regarding SSL, this is something we currently don't support but it's not a hard change and it's high on the priority list.

On Wed, May 18, 2011 at 9:56 PM, Sam Aparicio <s...@ringio.com> wrote:

This is very insightful feedback! Thanks for sending.