Cadastre-se
Alvodireto.com sua nova rede social Brasileira aqui você pode se conectar, compartilhar, anunciar e ganhar. Com quem é importante em sua vida.

Desenvolvedores

Como um desenvolvedor pode criar aplicativos e adicioná-los ao Alvodireto.com, aproveitando a base de Membros existentes. Podes hospedar o aplicativo, o que significa que estás em pleno controle das suas especificações de servidor.

Criação de uma App

Para interagir com o Alvodireto.com a tua aplicação pode emitir as chamadas para a nossa API e solicitar informações.

Quando tu adicionas uma aplicação para o nosso site damos-te um APP ID.

Solicitando um Token

Sempre que planear usar nossa API deve primeiro solicitar um token. Para solicitar um token precisa de uma chave única que enviamos para você quando um membro visite seu APP a partir de um iframe no nosso site. Nós repassá-lo como $_GET['key'].
Este é um exemplo de como podes solicitar um token:
http://www.alvodireto.com/token.php?key=$_GET['key']
Se for bem sucedido, receberás uma resposta JSON como:
Object
(
    [token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)

Enviar pedido

Agora que tens um token válido podes fazer pedidos para o nosso servidor. Com cada pedido deves passar o token que criamos para ti.
Uma chamada de exemplo para o nosso servidor API pareceria:
http://www.alvodireto.com/api.php?token=#{TOKEN}&method=#{METHOD_NAME}

Compreendendo uma resposta API

Para métodos que poderia retornar mais de um item a resposta conterá um indicador do total de itens disponíveis, bem como quantas páginas existem. Voltamos por padrão, no máximo, 10 itens e para conseguir os próximos 10 itens que você teria que passar o param "page=2".

Para a esquerda você encontrará uma lista dos módulos que implementar métodos API. Clique no módulo e você verá uma lista dos métodos que o aplicativo pode usar. Para efeitos de falta e de formatação que não incluem o pedido completo lá, mas apenas as partes mais relevantes.

friend
getFriends
GET /api.php?method=friend.getFriends&user_id=#{USER_ID}
Gets a full list of friends for a specific user. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
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.alvodireto.com/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://www.alvodireto.com/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://www.alvodireto.com/file/pic/user/7_120.jpg
                    [photo_original] => http://www.alvodireto.com/file/pic/user/7.jpg
                    [profile_url] => http://www.alvodireto.com/index.php?do=/jane-doe/
                )

        )

)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Checks if 2 users are friends or not. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
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}
Get the total number of unseen messages. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => 1
)
notification
getNewCount
GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}
Get the total number of unseen notifications. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
Object
(
    [api] => Object
        (
            [total] => 5
            [pages] => 0
            [current_page] => 0
        )

    [output] => 5
)
get
GET /api.php?method=notification.get&user_id=#{USER_ID}
Get all of the users notifications. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [notification_id] => 3
                    [link] => http://www.alvodireto.com/john-doe/comment-id_1/
                    [message] => Jane Doe commented on your wall
                    [icon] => http://www.alvodireto.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.
Resposta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [original] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
            [75px] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
            [100px] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
            [150px] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
            [240px] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
            [500px] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
            [1024px] => http://www.alvodireto.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_1024.jpg
        )

)
getPhotos
GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}
Get all the photos for a user. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [photo_100px] => http://www.alvodireto.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_100.jpg
                    [photo_240px] => http://www.alvodireto.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_240.jpg
                    [photo_original] => http://www.alvodireto.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c.jpg
                )

        )

)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Get information about a user based on the user ID# you pass. If you do not pass the #{USER_ID} we will return information about the user that is currently logged in.
Resposta
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.alvodireto.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://www.alvodireto.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://www.alvodireto.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://www.alvodireto.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://www.alvodireto.com/index.php?do=/john-doe/
        )

)