Регистрация ZuppaPeople - лучшая социальная сеть для геймеров.

Разработчикам

API
Являясь разработчиком, Вы можете создавать приложения и добавлять их на ..:: ZuppaPeople.com ::.. пользуясь преимуществами существующей пользовательской базы. Вы размещаете приложение, а это значит что вы полностью контролируете спецификации своего сервера

Приступая к созданию приложения

Для взаимодействия с ..:: ZuppaPeople.com ::.. ваше приложение может обращаться к к нашим API и запрашивать или размещать информацию

Когда вы добавите приложение на нашем сайте мы дадим вам APP ID.

Запрос токена

Если вы планируете воспользоваться нашими API, вам необходимо запросить токен. Для того, чтобы оформить запрос на токен, вам понадобится уникальный ключ, который мы отправим вам в момент, когда пользователь воспользуется вашим приложением через iframe на нашем сайте. Вот пример того, как это выглядит: $_GET['key'].
А вот пример того, как оформить запрос на токен:
http://zuppapeople.com/token.php?key=$_GET['key']
Если вы все сделали правильно, то в ответ вы получите вот такой JSON ответ:
Object
(
    [token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)

Отправка запроса

Получив от нас действующий токен, вы можете отсылать запросы на наш сервер. Каждый такой запрос обязательно должен включать в себя ваш персональный токен
Вот как должен выглядеть правильно составленный запрос к нашему API серверу:
http://zuppapeople.com/api.php?token=#{TOKEN}&method=#{METHOD_NAME}

Разъяснение ответа API

Для методов, которые могли вернуть больше одного значения, ответ будет содержать список всех доступных пунктов, а так же количество имеющихся страниц. Максимальное количество возвращаемых по умолчанию пунктов, равно 10-ти. Чтобы получить следующие 10 пунктов, Вам нужно будет передать param "page=2"

Слева вы найдете список модулей, которые используют метод API. Нажав на модуль, вы сможете ознакомиться со всеми методами, которыми может воспользоваться ваше приложение.

friend
getFriends
GET /api.php?method=friend.getFriends&user_id=#{USER_ID}
Получает полный список друзей определенного пользователя. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
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://zuppapeople.com/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://zuppapeople.com/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://zuppapeople.com/file/pic/user/7_120.jpg
                    [photo_original] => http://zuppapeople.com/file/pic/user/7.jpg
                    [profile_url] => http://zuppapeople.com/index.php?do=/jane-doe/
                )

        )

)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Проверка, являются ли 2 пользователя друзьями. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
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}
Получение общего количества непросмотренных сообщений. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => 1
)
notification
getNewCount
GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}
Получает полный список непросмотренных уведомлений. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
Object
(
    [api] => Object
        (
            [total] => 5
            [pages] => 0
            [current_page] => 0
        )

    [output] => 5
)
get
GET /api.php?method=notification.get&user_id=#{USER_ID}
Получает все уведомления пользователя. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

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

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

)
getPhotos
GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}
Получает все фотографии пользователя. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

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

        )

)
user
getUser
GET /api.php?method=user.getUser&user_id=#{USER_ID}
Получает информацию о пользователе, основываясь на переданном вами ID#. Если вы не укажете #{USER_ID} мы предоставим вам информацию о том пользователе, который в данный момент зарегистрирован в сети
Ответ
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://zuppapeople.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://zuppapeople.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://zuppapeople.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://zuppapeople.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://zuppapeople.com/index.php?do=/john-doe/
        )

)