3.1.1.   api_page_id

Page identifier from where the application was opened. Several server side API calls use this identifier. This parameter might be useful if your application can be added to multiple pages.

3.1.2.   api_user_auth

Parameter which you can use to guess user status on the page. Never use this to grant additional permissions based on this information, please validate the user status with a server side call.

• fan - user is logged in and following this page
• user - user is logged in and not following this page
• false - user is not logged in and therefore it is not known whether he is a follower of this page.
• admin - user is administrator of this page.

3.1.3.   dr_appw

Parameter which you can use to understand the position the application is placed. Possible values:

• 240 - application is added to front page of page and added to right column. Application width is 240px
• 480 - application is added to front page of page and added to center column. Application width is 480px
• 730 - application is added as a section of a page. Application width is 730px. This is the most widely used option.

3.2.1.   pages/userstatus

Returns current user status in application, used to verify user status on server side.

Request parameters:

Response values

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<draugiem>
        <status>ADMIN</status>
</draugiem>

In case application makes a request with a page_id that user has not installed, a status code 150 (access denied) is returned.

3.2.2.   pages/adminpages

Returns information about pages a specific user is administrator at.

Request parameters:

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<draugiem>
        <users>
                <user uid="13000622">
                        <name>Draugiem.lv lapas</name>
                        <surname/>
                        <nick/>
                        <place/>
                        <age>0</age>
                        <adult>0</adult>
                        <img>https://path.to.image/file.jpg</img>
                        <sex/>
                        <url>/pages</url>
                        <official>1</official>
                        <fans>15328</fans>
                </user>
                <user uid="13333333">
                        <name>afdsfdasfdsadfs</name>
                        ...
                </user>
        </users>
</draugiem>

Piezīme: a maximum of 100 pages are returned.

3.2.3.   pages/userpages

Returns pages the user is following (max 200)

Request parameters:

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<draugiem>
        <users>
                <user uid="13000622">
                        <name>Draugiem.lv lapas</name>
                        <surname/>
                        <nick/>
                        <place/>
                        <age>0</age>
                        <adult>0</adult>
                        <img>https://path.to.image/file.jpg</img>
                        <sex/>
                        <url>/pages</url>
                        <official>1</official>
                        <fans>15328</fans>
                </user>
                <user uid="13333333">
                        <name>afdsfdasfdsadfs</name>
                        ...
                </user>
        </users>
</draugiem>

3.2.4.   pages/info

Returns basic data about a specific page

Request parameters:

Example response:

<?xml version="1.0" encoding="UTF-8"?>
<draugiem>
        <users>
                <user uid="13000622">
                        <name>Draugiem lapas</name>
                        <surname></surname>
                        <nick></nick>
                        <place></place>
                        <age></age>
                        <adult>0</adult>
                        <img>https://i2.ifrype.com/business/000/622/v1300780832/sm_13000622.jpg</img>
                        <sex></sex>
                        <url>/pages</url>
                        <official>1</official>
                        <fans>15328</fans>
                </user>
        </users>
</draugiem>

3.3.1.   Send an invite to page

JavaScript function draugiemSendPageInvite(text, callback) opens a window where user of the application can sed an invitation to follow a page. Function works only when opened from within a specific page.

You can pass two optional parameters to this function:

User will choose friends to invite in the invitation window.

3.3.2.   Open "follow a page" popup window

You can open a popup window asking a user to follow a page with draugiemPagesFan() function.

You should pass a page ID of a page you wish to ask the user to follow

3.3.3.   User authentication request

By default all draugiem.lv page applications work anonymously. It means that no page applications have access to user data. Developers should take care of this by using draugiemAuthorize() function. You can call this function only after user interaction. e.g. no automatic calls within "onLoad" or similar events.

You can pass an optional argument as object:

{'followPage': true}

If you pass this parameter, user will have an option to start following the page within the same window where access to user data is granted.

Optional parameter to redirect user after successful authorization:

{'redirect': 'app-url/?success'}

By passing this parameter, user will be redirected to https://draugiem.lv/app-url/?success