Создать приложение
Как разработчик, вы можете создавать приложения и добавить их в сети соц сеть для женщин, воспользовавшись существующей базой пользователей. Вы размещаете приложение, что означает, что вы имеете полный контроль над вашей спецификацией сервера.
Настройка приложения
Для взаимодействия с соц сеть для женщин ваше приложение может выдать запрос к нашему API и получать или размещать информацию.Когда вы добавляете приложение на нашем сайте, мы даем вам APP ID.
Запрос маркера
Всякий раз, когда Вы планируете использовать наш API, Вы должны сначала запросить символ. Чтобы запросить символ, Вам нужен уникальный ключ, который мы Вам посылаем, когда пользователь посещает Ваше ПРИЛОЖЕНИЕ в iframe на нашем сайте. Мы проводим это как $_GET['key'].
Это пример того, как вы можете запросить маркер:
http://jenskayset.ru/token.php?key=$_GET['key']
В случае успеха вы получите ответ JSON, как:
Object
(
[token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)
Отправка запроса
Теперь, когда у Вас есть действительный символ, Вы можете обратиться с запросом к нашему серверу. С каждым запросом Вы должны передать символ, который мы создали для Вас.
Например, вызов нашего API сервера будет выглядеть:
http://jenskayset.ru/api.php?token=#{TOKEN}&method=#{METHOD_NAME}
Понимание ответа API
Для методов, которые могли возвратить больше чем один элемент, ответ будет содержать индикатор полных доступных элементов, а так же сколько там страниц. Мы возвращаем по умолчанию 10 элементов, и чтобы получить следующие 10 элементов, Вы должны передать параметр "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://jenskayset.ru/file/pic/user/7_50.jpg
[photo_50px_square] => http://jenskayset.ru/file/pic/user/7_50_square.jpg
[photo_120px] => http://jenskayset.ru/file/pic/user/7_120.jpg
[photo_original] => http://jenskayset.ru/file/pic/user/7.jpg
[profile_url] => http://jenskayset.ru/index.php?do=/jane-doe/
)
)
)
isFriend
GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}
Проверка, являются друзьями или нет. Если вы не сдали # {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}
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.
Ответ
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.
Ответ
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.
Ответ
Object
(
[api] => Object
(
[total] => 0
[pages] => 0
[current_page] => 0
)
[output] => Array
(
[0] => Object
(
[notification_id] => 3
[link] => http://jenskayset.ru/john-doe/comment-id_1/
[message] => Jane Doe commented on your wall
[icon] => http://jenskayset.ru/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://jenskayset.ru/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
[75px] => http://jenskayset.ru/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
[100px] => http://jenskayset.ru/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
[150px] => http://jenskayset.ru/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
[240px] => http://jenskayset.ru/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
[500px] => http://jenskayset.ru/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
[1024px] => http://jenskayset.ru/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.
Ответ
Object
(
[api] => Object
(
[total] => 1
[pages] => 0
[current_page] => 0
)
[output] => Array
(
[0] => Object
(
[photo_100px] => http://jenskayset.ru/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_100.jpg
[photo_240px] => http://jenskayset.ru/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_240.jpg
[photo_original] => http://jenskayset.ru/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.
Ответ
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://jenskayset.ru/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
[photo_50px_square] => http://jenskayset.ru/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
[photo_120px] => http://jenskayset.ru/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
[photo_original] => http://jenskayset.ru/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
[profile_url] => http://jenskayset.ru/index.php?do=/john-doe/
)
)