Введение
Даная информация будет полезна разработчикам, которые хотят использовать функционал forismatic в своих собственных программных продуктах.
Вызов методов API реализован в виде HTTP запросов на адрес
http://www.forismatic.com/api/1.0/. Параметры запроса передаются методом POST (URL-encoded). Формат, в котором сервер возвращает данные, передается отдельным параметром запроса. Сервер подерживает следующие форматы ответов:
http://www.forismatic.com/api/1.0/. Параметры запроса передаются методом POST (URL-encoded). Формат, в котором сервер возвращает данные, передается отдельным параметром запроса. Сервер подерживает следующие форматы ответов:
- xml
- json
- html
- text
Метод getQuote
Выбирает случайную цитату по переданому цифровому ключу, если ключ не указан, то на сервере генерируется случайный ключ. Ключ влияет на выбор цитаты. Параметры запроса:
- method=getQuote — имя метода, который необходимо вызвать
- format=<format> — один из поддерживаемых сервером форматов ответа
- key=<integer> — числовой ключ, который влияет на выбор цитаты, максимальная длина 6 символов
Пример запроса:
POST-запрос:
method=getQuote&key=457653&format=xml
ответ
<forismatic>
<quote>
<quoteText>Краткость — сестра таланта</quoteText>
<quoteAuthor></quoteAuthor>
<senderName>имя или ник кто прислал цитату</senderName>
<senderLink>email или адрес сайта того кто прислал</senderLink>
</quote>
</forismatic>
method=getQuote&key=457653&format=xml
ответ
<forismatic>
<quote>
<quoteText>Краткость — сестра таланта</quoteText>
<quoteAuthor></quoteAuthor>
<senderName>имя или ник кто прислал цитату</senderName>
<senderLink>email или адрес сайта того кто прислал</senderLink>
</quote>
</forismatic>