Fetching connections lists

connections = oa.connections()

connections now contains the “connections” portion of the result of the API call, as described in http://docs.oneall.com/api/resources/connections/list-all-connections/. Full response data (for debugging and whatnot) is in connections.response.

OneAll uses pagination for calls which contain many entries. Each call returns a page up to 500 entries. When the OneAll.connections() method is executed without arguments, only the first page is loaded. You the access the pagination information in connections.pagination.

In order to load a custom range of pages, you can do something like:

connections = oa.connections(first_page=3, last_page=6)

Or, if you want to load all pages, use:

connections = oa.connections(fetch_all=True)

Of course, this will result in multiple API calls.

The connections list itself is in connections.entries:

>>> connections.entries
[{u'callback_uri': u'http://www.example.com/connect/',
 u'connection_token': u'cf2fffc7-34dc-484e-95cd-13f8ab838e22',
 u'date_creation': u'Sun, 23 Jun 2013 14:12:43 +0200',
 u'status': u'succeeded'},
{u'callback_uri': u'http://m.example.com/connect/',
 u'connection_token': u'4276bd23-3605-4679-acd2-963148c477cc',
 u'date_creation': u'Sun, 23 Jun 2013 14:13:20 +0200',
 u'status': u'succeeded'},
{u'callback_uri': u'http://www.example.com/connect/',
 u'connection_token': u'58ad2a04-ed1e-4799-a3ca-2b26651e35a0',
 u'date_creation': u'Sun, 23 Jun 2013 14:18:00 +0200',
 u'status': u'succeeded'},
{u'callback_uri': u'http://m.example.com/connect/',
 u'connection_token': u'e5231790-c6dc-4ce8-9922-792a2aebbba2',
 u'date_creation': u'Sun, 23 Jun 2013 14:18:11 +0200',
 u'status': u'succeeded'},
{u'callback_uri': u'http://www.example.com/connect/',
 u'connection_token': u'f82ad1e5-113f-46a2-b1c5-2a57a6002401',
 u'date_creation': u'Sun, 23 Jun 2013 14:21:14 +0200',
 u'status': u'succeeded'}]

In the example above, you can see that some connections were made with the callback of the desktop website (http://www.example.com/connect/), and some were made with the mobile webapp (http://m.example.com/connect/). We can get an object grouped by the “callback_uri” using:

>>> connections.entries.by_callback_uri()
{u'http://www.example.com/connect/': [
    {u'callback_uri': u'http://www.example.com/connect/',
     u'connection_token': u'cf2fffc7-34dc-484e-95cd-13f8ab838e22',
     u'date_creation': u'Sun, 23 Jun 2013 14:12:43 +0200',
     u'status': u'succeeded'},
    {u'callback_uri': u'http://www.example.com/connect/',
     u'connection_token': u'58ad2a04-ed1e-4799-a3ca-2b26651e35a0',
     u'date_creation': u'Sun, 23 Jun 2013 14:18:00 +0200',
     u'status': u'succeeded'}],
    {u'callback_uri': u'http://www.example.com/connect/',
     u'connection_token': u'f82ad1e5-113f-46a2-b1c5-2a57a6002401',
     u'date_creation': u'Sun, 23 Jun 2013 14:21:14 +0200',
     u'status': u'succeeded'},
 u'http://m.example.com/connect/': [
    {u'callback_uri': u'http://m.example.com/connect/',
     u'connection_token': u'4276bd23-3605-4679-acd2-963148c477cc',
     u'date_creation': u'Sun, 23 Jun 2013 14:13:20 +0200',
     u'status': u'succeeded'},
    {u'callback_uri': u'http://m.example.com/connect/',
     u'connection_token': u'e5231790-c6dc-4ce8-9922-792a2aebbba2',
     u'date_creation': u'Sun, 23 Jun 2013 14:18:11 +0200',
     u'status': u'succeeded'}]}

Or get a list of connections with a specific “callback_uri”:

>>> connections.entries.by_callback_uri('http://m.example.com/connect/')
[{u'callback_uri': u'http://m.example.com/connect/',
 u'connection_token': u'4276bd23-3605-4679-acd2-963148c477cc',
 u'date_creation': u'Sun, 23 Jun 2013 14:13:20 +0200',
 u'status': u'succeeded'},
{u'callback_uri': u'http://m.example.com/connect/',
 u'connection_token': u'e5231790-c6dc-4ce8-9922-792a2aebbba2',
 u'date_creation': u'Sun, 23 Jun 2013 14:18:11 +0200',
 u'status': u'succeeded'}]

Reading connection details

In order to get the user_token and the user’s social identity you can pass a connection_token to the connection() method of the OneAll instance:

some_connection = oa.connection('e5231790-c6dc-4ce8-9922-792a2aebbba2')

Or, alternatively you can fetch the connection details through the connection() method of an entry in the list of connections:

some_connection = connections.entries[3].connection()

some_connection will now contain the “connection” portion of the response described in the API documentation for Read Connection Details, most importantly some_connection.user and some_connection.user.user_token

Fetching user list

OneAll.users() behaves the same way OneAll.connections() does, arguments and all. This is due to the similarity of the List Users and the List Connections API, in terms of pagination and entries structure.

users = oa.users()

Now, you can access users.entries, or even access detailed user data with users.entries[4].user().

Reading user details

Read user details using:

user_token = some_connection.user.user_token
some_user = oa.user(user_token)

some_user will contain the “user” portion of the response detailed at http://docs.oneall.com/api/resources/users/read-user-details/.

Reading user’s contacts

You can get the user’s contacts (depending on the social network) with:

contacts = some_user.contacts()

or, with:

contacts = oa.user_contacts(user_token)

Publishing content on user’s behalf

First, you need to format a message as described at http://docs.oneall.com/api/resources/users/write-to-users-wall/. Afterwards, publish it using publish():

message = {
    'request': {
        'message': {
            'parts': {
                'text': {
                    'body': 'Hello World!' }}}}}

oa.publish(user_token, message)