Iscriviti
phpFoxITA ti aiuta a connetterti e condividere con le persone della tua vita.

Sviluppatori

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

Creazione APP

Per interagire con phpFoxITA 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://phpfox.ypserver.net/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://phpfox.ypserver.net/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://phpfox.ypserver.net/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://phpfox.ypserver.net/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://phpfox.ypserver.net/file/pic/user/7_120.jpg
                    [photo_original] => http://phpfox.ypserver.net/file/pic/user/7.jpg
                    [profile_url] => http://phpfox.ypserver.net/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}
Numero totale di messaggi non letti. Se non passi un #{USER_ID} verranno restituiti 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 numtero totale di notifiche non lette. Se non passi un #{USER_ID} verranno restituite informazioni 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 utenti. Se non gli passi un #{USER_ID} verranno restituite informazioni sull attuale utente loggato.
Risposta
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [notification_id] => 3
                    [link] => http://phpfox.ypserver.net/john-doe/comment-id_1/
                    [message] => Jane Doe commented on your wall
                    [icon] => http://phpfox.ypserver.net/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://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
            [75px] => http://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
            [100px] => http://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
            [150px] => http://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
            [240px] => http://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
            [500px] => http://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
            [1024px] => http://phpfox.ypserver.net/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_1024.jpg
        )

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

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

        )

)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Ricevi info su un utente in base a ID utente che passi. 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
        (
            [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://phpfox.ypserver.net/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://phpfox.ypserver.net/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://phpfox.ypserver.net/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://phpfox.ypserver.net/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://phpfox.ypserver.net/index.php?do=/john-doe/
        )

)