Sviluppatori

In quanto sviluppatore puoi creare apps e aggiungerle a CardioPeople, prendendo vantaggio degli utenti esistenti. Tu hosti la app, che vuol dire pieno controllo delle tue specifiche server.

Creazione APP

Per interagire con CardioPeople la tua applicazione puo fare chiamate alle nostre API e richiedere o postare informazioni.

Quando aggiungi un App al nostro sito ti verra assegnato un APP ID.

Richiesta Token

Quando usi le nostre API devi prima richiedere un token. Per richiedere un token hai bisogno di una chiave unica che noi ti inviamo quando un utente visita la tua APP da un iframe sul nostro sito. Te la comunichiamo attraverso $_GET['key'].
Esempio di come puo essere richiesto un token:
http://www.cardiopeople-network.com/social/token.php?key=$_GET['key']
Se ha successo, riceverai una risposta del tipo JSON:
Object
(
    [token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)

Invio Richiesta

Ora che hai un token valido puoi fare richieste al nostro server. Per ogni richiesta devi passarci il token che abbiamo creato per te.
Esempio di chiamata alle nostre API:
http://www.cardiopeople-network.com/social/api.php?token=#{TOKEN}&method=#{METHOD_NAME}

Comprendere la Risposta API

Per metodi che possono restituire elementi multipli la risposta conterra un contatore di elementi totali disponibili. Per default restituiamo 10 elementi e per ricevere i successivi 10 devi passare il parametro "page=2".

A sinistra trovi un elenco di moduli che hanno metodi API. Clicca sul modulo e vedrai una lista di metodi che la tua App puo usare. Per brevita non abbiamo indicato la richiesta completa ma solo le parti piu rilevanti.

friend
getFriends
GET /api.php?method=friend.getFriends&user_id=#{USER_ID}
Prende una lista completa degli amici di utente. Se non passi #{USER_ID} verranno restituite info sull utente attulmente loggato.
Risposta
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.cardiopeople-network.com/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://www.cardiopeople-network.com/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://www.cardiopeople-network.com/file/pic/user/7_120.jpg
                    [photo_original] => http://www.cardiopeople-network.com/file/pic/user/7.jpg
                    [profile_url] => http://www.cardiopeople-network.com/index.php?do=/jane-doe/
                )

        )

)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Controlla se 2 utenti sono o non sono amici. Se non passi #{USER_ID} verranno restituite info sull utente attualmente loggato.
Risposta
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}
Ottiene il numero totale di messaggi non letti. Se non passi #{USER_ID} verranno restituite info sull utente attualmente loggato.
Risposta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => 1
)
notification
getNewCount
GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}
Prende il numero totale delle notifiche non viste. Se non passi il #{USER_ID} verranno restituite info sull utente loggato.
Risposta
Object
(
    [api] => Object
        (
            [total] => 5
            [pages] => 0
            [current_page] => 0
        )

    [output] => 5
)
get
GET /api.php?method=notification.get&user_id=#{USER_ID}
Prende tutte le notifiche utente. Se non passi il #{USER_ID} verrano restituite info sull utente loggato.
Risposta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

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

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

)
getPhotos
GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}
Ottiene tutte le foto di un utente. Se non passi #{USER_ID} verranno restituite info sull utente attualmente loggato.
Risposta
Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

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

        )

)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Ottiene info su un utente in base a ID# utente che passi. Se non passi #{USER_ID} verrano restituite info sull utente attualmente lggato.
Risposta
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.cardiopeople-network.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://www.cardiopeople-network.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://www.cardiopeople-network.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://www.cardiopeople-network.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://www.cardiopeople-network.com/index.php?do=/john-doe/
        )

)