Что предлагается?
Правила использования
Описание функций
Дополнительно: Статья о создании клиентов для Web Service
Что предлагается?
Разработаны веб-сервисы, которые позволяют получать актуальные стихи из Библии на каждый день непосредственно с сайта bible.uucyc.info, а также для поиска стихов по ключевым словам.
Web Services - это технология построения распределенных систем. Она основана на открытых стандартах - XML, SOAP, WSDL и HTTP. Данная технология позволяет легко интегрировать приложения, независимо от их платформы и языка разработки.
При использовании Web-сервисов Вы получаете непосредственные данные в формате XML, и эти данные могут быть легко интегрированы в дизайн Вашего сайта, либо в другое Ваше приложение.
Предлагаемая услуга является бесплатной.
Правила использования
Пожалуйста, ознакомьтесь с правилами использования веб-сервисов:
1) Администрация сайта bible.uucyc.info не несет никакой ответственности, связанной с предоставлением данной услуги и не гарантирует наличие передаваемой в рамках данной услуги информации.
2) Администрация оставляет за собой право прекратить оказание услуги любому из ее потребителей без указания причин.
3) Администрация не обязана оказывать консультационную и техническую поддержку по данной услуге в устном, письменном и ином виде.
4) Потребитель услуги обязуется проинформировать Администрацию сайта bible.uucyc.info по адресу webmaster@uucyc.info о факте использования услуги с момента начала ее использования, с указанием адреса (URL) своего сайта.
5) Потребитель услуги обязуется установить на страницы своего сайта, на которых отображается передаваемая в рамках данной услуги информация, графическу кнопку размера 88x31 со ссылкой на http://bible.uucyc.info.
Изображения и Код для размещения кнопки в различных вариантах:
Описание функций
Внимание! Для использования веб-сервисов необходимо прежде зарегистрироваться в качестве пользователя портала bible.uucyc.info
Ваши Имя и Пароль необходимы для доступа к функциям Web Services bible.uucyc.info
Кроме того, при использовании веб-сервисов, зарегистрированные пользователи смогут увидеть после пользовательского входа на bible.uucyc.info информацию о последней дате/времени использования веб-сервисов, месячного траффика и последние 10 выражений поиска с Вашего сайта на bible.uucyc-info
В целях регулирования общего траффика bible.uucyc.info, веб-сервисы ограничены для каждого пользователя по 10 Мегабайт в месяц.
При превышении траффика веб-сервисы до конца месяца недоступны. С наступлением нового месяца пользователь нашей службы получает вновь 10 Мегабайт.
Неиспользованный за месяц траффик в следующем месяце не учитывается.
Для написания клиентов на PHP используется модуль NuSoap for PHP.
Web Services на bible.uucyc.info предоставляет пользователям следующие функции:
-
getQuote('Ваш_Логин','Ваш_Пароль') - выдает стихи из Библии на каждый день. Возвращаемый результат представляет собой ассоциативный массив со следующими ключами:
- title
| - Заголовок с текущей датой (GMT+1) |
- ot_quote
| - Название стиха из Ветхого Завета |
- ot_content
| - Содержимое стиха из Ветхого Завета |
- nt_quote
| - Название стиха из Нового Завета |
- nt_content
| - Содержимое стиха из Нового Завета |
-
searchVersPlain('Поисковый запрос','область_поиска','Ваш_Логин','Ваш_Пароль') -выдает результат поиска в виде ассоциативного массива со следующими ключами:
- message
| - Возможное сообщение об отсутствии результата, ошибчного ввода и так далее. |
- found
| - Количество найденных совпадений |
- vxxxx
| - найденные стихи, где xxxx - определенное целое число. Содержимое переменной представляет собой строку с названием места из Библии и самим стихом с выделенным красным цветом поисковым словом, разделенных между собою знаком '@' |
Область поиска ограничивается следующими ключевыми параметрами:
- newtastament
| - Поиск в Новом Завете. |
- oldtastament
| - Поиск в Новом Завете |
- apokr
| - Поиск в Апокрифах |
- all
| - Поиск по всй Библии, включая Апокрифы |
-
searchVers('Поисковый запрос','область_поиска','Ваш_Логин','Ваш_Пароль') -выдает результат поиска в виде строки готового HTML-кода в виде таблицы "Место - Содержимое".
|