API dokumentacija
Metode prouke
Javno
Vraca 20 zadnjih poruka od odredenog korisnika u eljenom formatu
URL:
http://www.burence.com/api/messages/public.[format].[api_kljuc]
Formati: xml, json, rss
Prijatelji
Vraca prijatelje od odredenog korisnika u eljenom formatu.
URL:
http://www.burence.com/api/messages/friends/[user].[format].[api_kljuc]
Formati: xml, json, rss
Korisnici
Vraca sve javne poruke od odredenog korisnika u eljenom formatu.
URL:
http://www.burence.com/api/messages/user/[user].[format].[api_kljuc]
Formati: xml, json, rss
Poslednje
Vraca poslednju poruku od odredenog korisnika.
URL:
http://www.burence.com/api/messages/latest/[user].[format].[api_kljuc]
Formati: xml, json, rss
Poslati
Posts a public message. Returns its details or an error message in the desired format.
URL:
http://www.burence.com/api/messages/send.[format].[api_kljuc]
Metod:
POST
Potrebni prametri:
koisnicko ime
(authenticating user's username or ID)lozinka
(authenticating user's password)poruka
(message content)
Izbrisati
Removes authenticating user's message. Returns deleted message's details or an error message in the desired format.
URL:
http://www.burence.com/api/messages/delete.[format].[api_key]
Method:
POST
Required parameters:
username
(authenticating user's username or ID)password
(authenticating user's password)message_id
(message ID)
Direct message methods
Messages
Returns all direct messages that are in the authenticating user's inbox in the desired format.
URL:
http://www.burence.com/api/direct_messages/messages.[format].[api_key]
Method:
POST
Required parameters:
username
(authenticating user's username)password
(authenticating user's password)
Send
Posts a direct message to a user specified by their username or ID. Returns the sent message's details in the desired format or an error message in case of an error.
URL:
http://www.burence.com/api/direct_messages/send.[format].[api_key]
Method:
POST
Required parameters:
username
(authenticating user's username)password
(authenticating user's password)message
(username or ID of the recipient of the direct message)
reply
(ID of a message, to which the current message is a reply)direct
(recipient username or id)
Delete
Removes a direct message from the authenticating user's inbox and returns removed message's details in the desired format or an error message in case of an error.
URL:
http://www.burence.com/api/direct_messages/delete.[format].[api_key]
Method:
POST
Required parameters:
username
(authenticating user's username)password
(authenticating user's password)message_id
(ID of the message to be deleted)
User methods
Friends
Returns specified user's friends in the desired format.
- URL:
http://www.burence.com/api/users/friends/[user].[format].[api_key]
- Formats: xml, json
- Usage example:
http://www.burence.com/api/users/friends/johnny.xml
ouhttp://www.burence.com/api/users/friends/12345.json
Followers
Returns specified user's followers in the desired format.
URL:
http://www.burence.com/api/users/followers/[user].[format].[api_key]
Formats: xml, json
Usage example:
http://www.burence.com/api/users/followers/diana.jsonou
http://www.burence.com/api/users/followers/584.xml
User details
Returns user's details in the desired format.
URL:
http://www.burence.com/api/users/details/[user].[format].[api_key]
Formats: xml, json
Usage example:
http://www.burence.com/api/users/details/diana.json.f9cv8d97c90d8c6f2cab37bb6d1f1335ou
http://www.burence.com/api/users/details/584.xml.f9f16d97c90d8c6f23sb37bb6d1f1992
Friendship methods
Create
Adds a specified user to the authenticating user's friends. Returns the befriended user's details in the desired format or an error message in case of an error.
Method:
POST
Required parameters:
username
(authenticating user's username)password
(authenticating user's password)friend
(befriended user's username or ID)
http://www.burence.com/api/friendships/create.[format].[api_key]
Formats: xml, json
Destroy
Removes a specified (leaves) user from the authenticating user's friend list. Returns the removed user's details in the desired format ro an error message in case of an error.
Method:
POST
Required parameters:
username
(authenticating user's username)password
(authenticating user's password)friend
(left user's username or ID)
http://www.burence.com/api/friendships/destroy.[format].[api_key]
Formats: xml, json