3.1.1.   api_page_id

Atveramās lapas identifikators, katrai lapai unikāls, parasti lielāks par 13 000 000. Atsevišķos API pieprasījumos šī vērtība ir jāpadod kā parametrs, tāpēc būtu vēlams to saglabāt sesijā vai kā citādi.

3.1.2.   api_user_auth

Parametrs, ar kura palīdzību ir iespējams noteikt lietotāja statusu lapā, neprasot pieeju lietotāja datiem. Iespējamās vērtības:

• fan - lietotājs ir autorizējies draugiem.lv un ir lapas sekotājs
• user - lietotājs ir autorizējies draugiem.lv, bet nav lapas sekotājs
• false - lietotājs nav autorizējies draugiem.lv, nav informācijas par sekošanas statusu
• admin - lietotājs ir lapas administrators

3.1.3.   dr_appw

Parametrs, kas ļauj noskaidrot, kurā vietā aplikācija ir ievietota lapā. Iespējamās vērtības

• 240 - aplikācija ir pievienota lapas sākumlapā kā bloks labajā kolonā, pieejamais platums 240px
• 480 - aplikācija ir pievienota lapas sākumlapā kā bloks centrālajā kolonā, pieejamais platums 480px
• 730 - aplikācija ir pievienota kā lapas sadaļa, pieejamais platums 730px

3.2.1.   pages/userstatus

Izsaukums, kas ļauj noteikt pašreizējā apmeklētāja statusu lapā.

Pieprasījuma parametri:

Atbildes

Pieprasījuma atbildes paraugs:

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

Gadījumā, ja aplikācija veiks šo izsaukumu ar lapas identifikatoru page_id, kurš nav uzstādījis šo aplikāciju, tad tiks atgriezts kļūdas statusa kods 150 (access denied).

3.2.2.   pages/adminpages

Izsaukums, kas piekļūt informācijai par lietotāja administrējamām lapām. Šie dati varētu būt aktuāli aplikācijām, kas ir paredzētas vairāk kā vienai lapai.

Pieprasījuma parametri:

Pieprasījuma atbildes paraugs:

<?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: šobrīd tiek atgrieztas ne vairāk kā 100 administrējamās lapas, taču tai normālā gadījumā nevajadzētu bū problēmai.

3.2.3.   pages/userpages

Izsaukums atgriež lapas, kurām lietotājs seko (max 200 gab)

Pieprasījuma parametri:

Pieprasījuma atbildes paraugs:

<?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

Pieprasījums atgriež informāciju par konkrētu draugiem.lv lapu

Pieprasījuma parametri:

Pieprasījuma atbildes paraugs:

<?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.   Uzaicinājuma uz lapu sūtīšana draugiem

Izmantojot Javascript funkciju draugiemSendPageInvite(text, callback), iespējams atvērt logu, no kura aplikācijas lietotājs var saviem draugiem nosūtīt uzaicinājumu pievienoties atvērtās lapas sekotājiem. Funkcija darbojas tikai no lietotāja atvērtās lapas, kurā integrēta aplikācija.

Funkcijai var padot divus neobligātus argumentus:

Uzaicinājuma logā lietotājs varēs izvēlēties, kuriem no saviem draugiem nosūtīt uzaicinājumu.

3.3.2.   Lapas sekošanas dialogloga atvēršana

Izmantojot Javascript funkciju draugiemPagesFan(), iespējams atvērt apstiprinājuma logu, kas ļauj lietotajam pievienoties par fanu atvērtajai lapai.

Funkcijai ir jāpadod parametrs ar lapas identifikatoru, kurai lapai sākt sekot. Lapas identifikatoru var atrast atverot lapu kreisajā kolonā zem visa pārējā satura:

3.3.3.   Lietotāja autorizācijas pieprasījums

Pēc noklusējuma visas draugiem.lv lapu aplikācijas darbojas anonīmā režīmā. Tas nozīmē, ka nevienai lapu aplikācijai automātiski netiek prasīta pieeja lietotāja datiem. Programmētājam pašam ir jāparūpējas, lai tiktu pieprasīta pieeja lietotāja datiem izmantojot draugiemAuthorize() funkciju. Šo funkciju ir atļauts izsaukt tikai pēc lietotāja klikšķa veikšanas.

Funkcijai var padot neobligātu parametru objektu:

{'followPage': true}

Padodot šādu parametru objektu lietotājam pie datu pieprasījuma tiks piedāvāts automātiski sākt sekot lapai, kurā aplikācija ir ievietota - izlecošajā logā tiks atvērts uzstādījumu saraksts, kurā būs iezīmēta iespēja "sākt sekot lapai". Ja lietotājs nevēlas sekot lapai, viņš var izņemt ķeksi un vienalga piekļūt aplikācijai, dodot piekļuvi saviem datiem.

Neobligāts parametru objekts, lietotāja pāradresēšanai:

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

Padodot šādu parametru, lietotājs pēc veiksmīgas autorizācijas tiks pāradresēts uz norādīto adresi https://draugiem.lv/app-url/?success