Sviluppatori

Come sviluppatore puoi creare applicazioni e aggiungerle a Collezioni d'Arte, sfruttando la base di utenti già esistente. Si ospita l'applicazione, il che significa che si è in pieno controllo delle tue specifiche del server.

Impostazione di un applicazione

Per interagire con Collezioni d'Arte l'applicazione può emettere chiamate alla nostra API e richiedere o inserire le informazioni.

Quando aggiungi un'applicazione al nostro sito ti daremo un'APP ID.

Richiesta di Token

Ogni volta che si pensa di utilizzare la nostra API è necessario richiedere un token. Per richiedere un token hai bisogno di una chiave univoca che inviamo a voi quando un utente visita la tua applicazione da un iframe sul nostro sito. Passiamo questo insieme come $_GET['key'].
Questo è un esempio di come puoi richiedere un token:
http://chatandshop.eu/token.php?key=$_GET['key']
In caso di successo, si otterrà una risposta JSON come:
Object
(
    [token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)

Sto inviando una richiesta

Ora che si dispone di un token valido è possibile effettuare richieste al nostro server. Con ogni richiesta, devi passare il token che abbiamo creato per te.
Una esempio di chiamata per il nostro server API assomiglierebbe a:
http://chatandshop.eu/api.php?token=#{TOKEN}&method=#{METHOD_NAME}

Capire una risposta API

Per i metodi che potrebbero restituire più di un articolo la risposta conterrà un indicatore delle voci totali disponibili così come quante pagine ci sono. Indichiamo per impostazione predefinita 10 articoli al massimo e al fine di ottenere i successivi 10 elementi si dovrebbe indicare il parametro"pagina=2".

A sinistra troverete una lista dei moduli che implementano metodi API. Clicca sul modulo e vedrete un elenco dei metodi che l'applicazione può utilizzare. Per motivi di brevità e di formattazione non includiamo la richiesta completa, ma solo le parti più rilevanti.

friend
getFriends
GET /api.php?method=friend.getFriends&user_id=#{USER_ID}
Ottiene un elenco completo degli amici di un utente specifico. Se non si passa il #{USER_ID} renderemo informazioni sull'utente che è attualmente connesso.
Response
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://chatandshop.eu/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://chatandshop.eu/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://chatandshop.eu/file/pic/user/7_120.jpg
                    [photo_original] => http://chatandshop.eu/file/pic/user/7.jpg
                    [profile_url] => http://chatandshop.eu/index.php?do=/jane-doe/
                )

        )

)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Verifica se due utenti sono amici o meno. Se non passa #{USER_ID} renderemo informazioni sull'utente che è attualmente connesso.
Response
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}
Ottienii il numero totale di messaggi invisibili. Se non si passa l'#{USER_ID} invieremo informazioni sull'utente che sta attualmente loggato
Response
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => 1
)
notification
getNewCount
GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}
Ottieni il numero totale di notifiche invisibili. Se non si passa l'#{USER_ID} invieremo informazioni sull'utente che sta attualmente loggato
Response
Object
(
    [api] => Object
        (
            [total] => 5
            [pages] => 0
            [current_page] => 0
        )

    [output] => 5
)
get
GET /api.php?method=notification.get&user_id=#{USER_ID}
Ricevi tutte le notifiche degli utenti. Se non si passa l'# {USER_ID} invieremo informazioni sull'utente che sta attualmente loggato
Response
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

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

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

)
getPhotos
GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}
Ricevi tutte le foto di un utente. Se non si passa l'#{USER_ID} mostreremo informazioni sull'utente che è attualmente connesso.
Response
Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

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

        )

)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Ottieni informazioni su un utente in base all'ID utente che si passa. Se non si passa l'# {USER_ID} invieremo informazioni sull'utente che sta attualmente loggato
Response
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://chatandshop.eu/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://chatandshop.eu/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://chatandshop.eu/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://chatandshop.eu/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://chatandshop.eu/index.php?do=/john-doe/
        )

)