|
| |||
| Тип Топпер - чаты, микроблоги, новости, общение, поиск друзей, интернет пейджер | ||||
|
|
|
| |||
| Тип Топпер - чаты, микроблоги, новости, общение, поиск друзей, интернет пейджер | ||||
|
|
|
|
Stranger. Разговор с незнакомцем. (0) API v2.0, От TopperOne  (web) , 16 09 2009, 14:18 0. Введение. Для организации разговора используются три скрипта: http://stranger.tip-topper.ru/api_start.php - старт нового разговора http://stranger.tip-topper.ru/api_rec.php - запрос новых сообщений http://stranger.tip-topper.ru/api_send.php - отправка собщений Во всех скриптах параметры можно передавать на сервер как методом POST, так и методом GET. 1. Старт нового разговора. 1.1. Необходимо сгенерировать уникальное имя - от 10 до 15 символов. Пример "1234567890" 1.2. Отправляем имя скрипту. Пример запроса GET: http://stranger.tip-topper.ru/api_start.php?username=1234567890 1.3. Скрипт возвращает уникальный цифровой идентификатор разговора или ошибку "error" в формате XML. Примеры ответов: 1. Ошибка с кодом 1. <?xml version="1.0" ?> <Headline> <ID>error</ID> <ErCode>1</ErCode> </Headline> 2. Разговор успешно стартовал в режиме присоединения к ожидающему или создания нового в режиме ожидания. Разговору присвоен идентификатор "22360". <?xml version="1.0" ?> <Headline> <ID>22360</ID> </Headline> 1.4. Значения полей. 1.4.1. ID. Содержит идентификатор разговора или значение "error". 1.4.2. ErCode. Код ошибки. 2. Начало созданного разговора. 2.1. Каждые 22 секунды не активный разговор удаляется, следовательно, чтобы поддерживать разговор активным, необходимо не реже чем раз 10-20 секунд делать запрос по адресу "http://stranger.tip-topper.ru/api_rec.php" с полученными в первом пункте параметрами: имя и идентификатор. Пример запроса: http://stranger.tip-topper.ru/api_rec.php?username=1234567890&id=22360 2.2. Скрипт возвращает данные в формате XML. Примеры ответов: 1. Ответ со статусом 2 и значением количества активных разговоров. <?xml version="1.0" ?> <Headline> <Status>2</Status> <OnLine>14</OnLine> </Headline> 2. Ответ с новыми сообщениями. <?xml version="1.0" ?> <Headline> <New>2</New> <LastID>109992</LastID> <OnLine>14</OnLine> <Status>9</Status> </Headline> <Objects> <Item> <Name>2</Name> <Time>22:37:11</Time> <Text>Второе сообщение</Text> </Item> <Item> <Name>2</Name> <Time>22:37:09</Time> <Text>Первое сообщение</Text> </Item> </Objects> 2.3. Значения полей. 2.3.1. Status. Поле с кодом состояния разговора: 1 - разговор начался, но ни одного сообщения нет; 2 - разговор закончился, собеседник ушел; 7 - разговор создан, но собеседник еще не присоединился, т.е. разговор в режиме ожидания; 9 - разговор активен. это текст сообщения (все новые сообщения, включая и свои собственные). 2.3.2. LastID. Поле с номером последнего полученного сообщения. В случае, если ни одного сообщения нет, то пусто. 2.3.3. New. Поле с количеством новых сообщений. 0 - нет новых сообщений, иначе - количество новых сообщений. Свои сообщения не учитываются. 2.3.4. OnLine. Количество активных разговоров на момент запроса. 2.3.5. Objects. Блок сообщений. 2.3.6. Item. Блок сообщения. 2.3.7. Name. 1 - свое сообщение; 2 -от незнакомца. 2.3.8. Time. Время в формате часы:минуты:секунды 2.3.9. Text. Текст сообщения 2.4. Если разговор находится в активном состоянии, то запрос на новые сообщения производится по тому же адресу (http://stranger.tip-topper.ru/api_rec.php), но с добавлением номера последнего сообщения, полученного при предыдущем запросе. Пример запроса: http://stranger.tip-topper.ru/api_rec.php?username=1234567890&id=22360&lastid=109992 В примере #2 мы получили: Количество новых сообщений: 2 Номер сообщения: 109992 Количество активных разговоров: 14 Статус разговора: 9 (активен) И два тела сообщения: Сообщение 1: От кого: "2" (от незнакомца) Время: "22:37:09" Текст: "Первое сообщение" Сообщение 2: От кого: "2" (от незнакомца) Время: "22:37:11" Текст: "Второе сообщение" Исходя из полученных данных, следующий запрос должен содержать в себе номер последнего сообщения - 114972. Пример запроса: http://stranger.tip-topper.ru/randchat1.php?username=1234567890&id=22360&lastid=114972 2.5. В запросе может присутствовать параметр "mymess", отвечающий за загрузку сообщений "от себя". Если параметр имеет значение "1", то свои сообщения так же будут получены. При отсутствии параметра или любом другом значении ответ сервера будет содержать только ответы от незнакомца. 3. Отправка сообщения. 3.1. Отправка производится на адрес "http://stranger.tip-topper.ru/api_send.php". Параметры отправки: имя, идентификатор и текст сообщения. Пример запроса: http://stranger.tip-topper.ru/api_send.php?username=1234567890&id=22360&text=test 3.2. Скрипт возвращает ответ в формате XML. Примеры ответов: 1. Ответ скрипта "error". <?xml version="1.0" ?> <Headline> <ID>error</ID> <ErCode>1</ErCode> </Headline> 2. Ответ скрипта "OK". <?xml version="1.0" ?> <Headline> <ID>OK</ID> </Headline> 3.3. Значения полей. 3.3.1. ID. Содержит значение "OK" или значение "error". 3.3.2. ErCode. Код ошибки. Источник Теги: Разговор с незнакомцем API На главную Перейти к блогу Постоянная ссылка Оставлять комментарии могут только зарегистрированные пользователи. Зарегистрироваться? |
|
Программы Новости и обзоры техники Мобильные технологии IT-новости Авто Культура, Кино, Театр Мировые новости, политика Юмор Спорт
Спам на красивом русском языке С 17 ноября в Евросоюзе можно будет купить только самогаснущие сигареты НЕ ПУГАЙТЕ КОТОВ! Евро-2012 и Азовское побережье Разработан метод лечения кариеса без бормашины и пломб «Остров Утопия» возводится у побережья Калифорнии Обнаружена планета, состоящая из алмазов Американцы обнаружили ошибку в расчетах древних майя Посмертная жизнь существует
Блогостранствие HardwareNews Новости мира всяка всяча Чудеса Автоновости. С мира по нитке... ИНТЕРЕСНЫЕ ФАКТЫ |
© 2008-2010 ООО «АНС-Проект»
