Get Friend Ids

Description

This method retrieves the list of identity ids of all your contacts and the identities which they have shared with you. It also retrieves all of the times which you have poken'ed with the friend.

HTTP Method

GET

Path

/friends/contact

Authentication

Requires an authenticated user.

Parameters

No Parameters.

Error Codes

150001 ( Common )

The endpoint requires an authenticated account

30000 ( Friends )

An unhandled exception has occured.

Response Schema

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema elementFormDefault="qualified" version="1.0" targetNamespace="http://xsd.poken.com" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="contactsInfo">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="expireDate" type="xs:dateTime"/>
        <xs:element name="contact" nillable="true" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="accountId" type="xs:long"/>
              <xs:element name="identity" nillable="true" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element name="identityId" type="xs:long"/>
                    <xs:element name="access" type="xs:string"/>
                    <xs:element name="label" type="xs:string" minOccurs="0"/>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
              <xs:element name="tag" type="xs:string" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
              <xs:element name="note" type="xs:string" minOccurs="0"/>
              <xs:element name="eventDate" type="xs:dateTime" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element name="unregistered" nillable="true" minOccurs="0" maxOccurs="unbounded">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="hardwareId" type="xs:long"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<contactsInfo xmlns="http://xsd.poken.com">
	<expireDate>2009-09-08T12:11:25.882-07:00</expireDate>
	<contact>
		<accountId>227812</accountId>
		<identity>
			<identityId>227862</identityId>
			<access>READ</access>
		</identity>
		<note>Added</note>
		<eventDate>2009-03-05T09:01:14.977-08:00</eventDate>
	</contact>
	<contact>
		<accountId>2</accountId>
		<identity>
			<identityId>52</identityId>
			<access>READ</access>
		</identity>
		<note></note>
		<eventDate>2009-05-08T06:04:25.000-07:00</eventDate>
		<eventDate>2009-03-05T05:50:00.000-08:00</eventDate>
	</contact>
	<contact>
		<accountId>186970</accountId>
		<identity>
			<identityId>187025</identityId>
			<access>READ</access>
		</identity>
		<note></note>
		<eventDate>2009-05-08T06:04:42.000-07:00</eventDate>
		<eventDate>2009-04-30T04:47:20.000-07:00</eventDate>
		<eventDate>2009-04-30T04:46:40.000-07:00</eventDate>
		<eventDate>2009-04-15T02:50:00.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>102743</accountId>
		<identity>
			<identityId>102885</identityId>
			<access>READ</access>
		</identity>
		<tag>boggy</tag>
		<tag>Poken Application</tag>
		<note>Added</note>
		<eventDate>2009-06-09T09:31:16.000-07:00</eventDate>
		<eventDate>2009-06-09T09:30:00.000-07:00</eventDate>
		<eventDate>2009-05-19T03:46:40.000-07:00</eventDate>
		<eventDate>2009-05-08T05:50:00.000-07:00</eventDate>
		<eventDate>2009-04-27T04:50:00.000-07:00</eventDate>
		<eventDate>2009-04-15T02:50:00.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>5</accountId>
		<identity>
			<identityId>495880</identityId>
			<access>READ</access>
		</identity>
		<identity>
			<identityId>518330</identityId>
			<access>READ</access>
		</identity>
		<identity>
			<identityId>13362</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-17T08:34:00.000-07:00</eventDate>
		<eventDate>2009-06-15T06:20:00.000-07:00</eventDate>
		<eventDate>2009-04-30T04:46:40.000-07:00</eventDate>
		<eventDate>2009-04-15T02:50:00.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>4604</accountId>
		<identity>
			<identityId>14208</identityId>
			<access>READ</access>
		</identity>
		<identity>
			<identityId>14207</identityId>
			<access>READ</access>
		</identity>
		<note></note>
		<eventDate>2009-05-19T03:55:22.000-07:00</eventDate>
		<eventDate>2009-05-08T05:50:00.000-07:00</eventDate>
		<eventDate>2009-04-17T05:56:40.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>1003</accountId>
		<identity>
			<identityId>2734</identityId>
			<access>READ</access>
		</identity>
		<note></note>
		<eventDate>2009-05-19T03:55:21.000-07:00</eventDate>
		<eventDate>2009-04-30T04:46:40.000-07:00</eventDate>
		<eventDate>2009-04-17T05:56:40.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>20657</accountId>
		<identity>
			<identityId>20708</identityId>
			<access>READ</access>
		</identity>
		<tag>alan</tag>
		<note></note>
		<eventDate>2009-05-19T03:55:56.000-07:00</eventDate>
		<eventDate>2009-05-04T06:33:20.000-07:00</eventDate>
		<eventDate>2009-04-17T01:13:20.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>4</accountId>
		<identity>
			<identityId>904</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-11T01:28:35.000-07:00</eventDate>
		<eventDate>2009-06-11T01:13:20.000-07:00</eventDate>
		<eventDate>2009-05-08T05:50:00.000-07:00</eventDate>
		<eventDate>2009-04-20T05:20:00.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>1007</accountId>
		<identity>
			<identityId>1348</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-15T06:20:43.000-07:00</eventDate>
		<eventDate>2009-06-11T01:13:20.000-07:00</eventDate>
		<eventDate>2009-05-19T03:46:40.000-07:00</eventDate>
		<eventDate>2009-05-04T06:33:20.000-07:00</eventDate>
		<eventDate>2009-04-23T05:33:20.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>1006</accountId>
		<identity>
			<identityId>1327</identityId>
			<access>READ</access>
		</identity>
		<note></note>
		<eventDate>2009-04-30T04:47:21.000-07:00</eventDate>
		<eventDate>2009-04-30T04:46:40.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>3</accountId>
		<identity>
			<identityId>97</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-15T06:31:22.000-07:00</eventDate>
		<eventDate>2009-06-15T06:03:20.000-07:00</eventDate>
		<eventDate>2009-05-07T06:30:00.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>563034</accountId>
		<identity>
			<identityId>563088</identityId>
			<access>READ</access>
		</identity>
		<note></note>
		<eventDate>2009-05-07T13:13:24.605-07:00</eventDate>
	</contact>
	<contact>
		<accountId>605517</accountId>
		<identity>
			<identityId>605090</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-12T06:00:46.000-07:00</eventDate>
		<eventDate>2009-06-09T23:40:00.000-07:00</eventDate>
		<eventDate>2009-05-10T10:03:20.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>227820</accountId>
		<identity>
			<identityId>227870</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-26T02:09:34.000-07:00</eventDate>
		<eventDate>2009-06-26T02:03:20.000-07:00</eventDate>
		<eventDate>2009-06-09T08:56:40.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>614320</accountId>
		<identity>
			<identityId>614088</identityId>
			<access>READ</access>
		</identity>
		<identity>
			<identityId>614080</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-10T03:48:10.000-07:00</eventDate>
		<eventDate>2009-06-09T23:40:00.000-07:00</eventDate>
	</contact>
	<contact>
		<accountId>130954</accountId>
		<identity>
			<identityId>130811</identityId>
			<access>READ</access>
		</identity>
		<tag>Poken Application</tag>
		<note></note>
		<eventDate>2009-06-15T00:55:48.000-07:00</eventDate>
		<eventDate>2009-06-11T01:13:20.000-07:00</eventDate>
	</contact>
</contactsInfo>