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