Kreiraj Aplikaciju
Kao programer možete praviti aplikacije i dodati ih na Moje Društvo.Com, i tako iskoristiti postojeću bazu članova. Vi hostujete aplikaciju, što znači da imate punu kontrolu.
Podešavanje Aplikacije
Da se povežete sa našim sajtom Moje Društvo.Com vaša aplikacija može vršiti zahtjeve prema našem API i zahtjevati da objavi informacije.Kada dodate aplikaciju na naš sajt dodijelićemo vam APP ID.
Zahtjevanje Tokena
Kada god planirate koristiti API morate prvo zahtjevati token. Da biste zahtjevali token morate kreirati unikatan ključ koji ćemo vam poslati kada korisnik posjeti Aplikaciju sa ifrejma na našem sajtu. Mi prenosimo ovo zajedno sa $_GET['key'].
Ovo je primjer kako možete zahtjevati token:
http://www.mojedrustvo.com/token.php?key=$_GET['key']
Ako je uspješno, dobićete JSON odgovor kao:
Object
(
[token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)
Slanje Zahtjeva
Sada kada imate valjan token možete praviti zahtjeve prema našem serveru. Sa svakim zahtjevom morate prenjeti token koji smo kreirali za vas.
Primjer poziva prema našem API serveru bi izgledao ovako:
http://www.mojedrustvo.com/api.php?token=#{TOKEN}&method=#{METHOD_NAME}
Razumijevanje API Odgovora.
Za metode koje mogu vratiti više od jednog sadržaja odgovor će sadržavati indikator ukupno dostupnih sadržaja kao i broj dostupni strana. Podrazumijevano vraćamo najviše 10 sadržaja i da biste dobili sledećih 0 sadržaja morate da prenesete parametar "page=2".
Lijevo ćete pronaći spisak modula koji implementiraju API metode. Kliknite na modul i vidjećete spisak metoda koje vaša aplikacija može koristiti. Za kraće i svrhe formatiranja ne uključujemo puni zahtjev tu već samo relevantne zahtjeve.
friend
getFriends
GET /api.php?method=friend.getFriends&user_id=#{USER_ID}
Kreira čitavu listu prijatelja za specifičnog korisnika. Ako ne prenesete #{USER_ID} vratićemo informacije o trenutno prijavljenom korisniku.
Odgovori
Object
(
[api] => Object
(
[total] => 1
[pages] => 0
[current_page] => 0
)
[output] => Array
(
[0] => Object
(
[user_id] => 7
[user_name] => jane-doe
[full_name] => Jane Doe
[joined] => 1314110027
[country_iso] => US
[gender] => Female
[photo_50px] => http://www.mojedrustvo.com/file/pic/user/7_50.jpg
[photo_50px_square] => http://www.mojedrustvo.com/file/pic/user/7_50_square.jpg
[photo_120px] => http://www.mojedrustvo.com/file/pic/user/7_120.jpg
[photo_original] => http://www.mojedrustvo.com/file/pic/user/7.jpg
[profile_url] => http://www.mojedrustvo.com/index.php?do=/jane-doe/
)
)
)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Provjerava dali su ova 2 člana ili ne. Ako neprenesete #{USER_ID} mi ćemo vratiti informacije o korisniku koji je trenutno prijavljen.
Odgovori
Object
(
[api] => Object
(
[total] => 0
[pages] => 0
[current_page] => 0
)
[output] => Object
(
[is_friend] => 1
)
)
mail
getNewCount
GET /api.php?method=mail.getNewCount&user_id=#{USER_ID}
Prikaži ukupan broj neviđenih poruka. Ako neprenesete #{USER_ID} vratićemo vam podatke vezane za trenutno prijavljenog člana.
Odgovori
Object
(
[api] => Object
(
[total] => 0
[pages] => 0
[current_page] => 0
)
[output] => 1
)
notification
getNewCount
GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}
Prikaži ukupan broj neviđenih obavijesti. Ako ne prenesete #{USER_ID} vratićemo vam podatke za trenutno prijavljenog čalana.
Odgovori
Object
(
[api] => Object
(
[total] => 5
[pages] => 0
[current_page] => 0
)
[output] => 5
)
get
GET /api.php?method=notification.get&user_id=#{USER_ID}
Dobij sve obavijesti korisnika. Ako ne prenesete #{USER_ID} vratićemo vam informacije o korisniku koji je trenutno prijavljen.
Odgovori
Object
(
[api] => Object
(
[total] => 0
[pages] => 0
[current_page] => 0
)
[output] => Array
(
[0] => Object
(
[notification_id] => 3
[link] => http://www.mojedrustvo.com/john-doe/comment-id_1/
[message] => Jane Doe commented on your wall
[icon] => http://www.mojedrustvo.com/module/blog/static/image/default/default/activity.png
)
)
)
photo
addPhoto
POST /api.php?method=photo.addPhoto&photo=#{@FILE_PATH;TYPE=MIME_TYPE}&photo_name=#{BASE_FILE_NAME}
Uploads a photo on behalf of the user.
Odgovori
Object
(
[api] => Object
(
[total] => 0
[pages] => 0
[current_page] => 0
)
[output] => Object
(
[original] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
[75px] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
[100px] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
[150px] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
[240px] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
[500px] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
[1024px] => http://www.mojedrustvo.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_1024.jpg
)
)
getPhotos
GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}
Dobij sve slike od korisnika. Ako ne podesite #{USER_ID} vratićemo podatke od trenutno prijavljenog korisnika.
Odgovori
Object
(
[api] => Object
(
[total] => 1
[pages] => 0
[current_page] => 0
)
[output] => Array
(
[0] => Object
(
[photo_100px] => http://www.mojedrustvo.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_100.jpg
[photo_240px] => http://www.mojedrustvo.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_240.jpg
[photo_original] => http://www.mojedrustvo.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c.jpg
)
)
)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Saznaj detalje o korisniku koristeći ID# korisnika. Ako ne prenesete #{USER_ID} biće prikazani podaci za trenutno prijavljenog korisnika.
Odgovori
Object
(
[api] => Object
(
[total] => 0
[pages] => 0
[current_page] => 0
)
[output] => Object
(
[user_id] => 1
[user_name] => john-doe
[joined] => 1314109907
[gender] => Male
[country_iso] => US
[full_name] => John Doe
[email] => john.doe@site.com
[photo_50px] => http://www.mojedrustvo.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
[photo_50px_square] => http://www.mojedrustvo.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
[photo_120px] => http://www.mojedrustvo.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
[photo_original] => http://www.mojedrustvo.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
[profile_url] => http://www.mojedrustvo.com/index.php?do=/john-doe/
)
)
Bosanski