API
Этот раздел предназначен для разработчиков, теперь имеющих возможность встраивать показ пинаторов в своих программных продуктах.
Вызов API
Осуществляется GET-запросом и имеет следующий вид:
http://pinator.org/api/?method=getRandomQuote&format=jsonp&funcName=myFunction
Доступные методы:
-
getRandomQuote - возвращает случайный пинатор
Параметры для формата ответа:
- format=json - результат в формате JSON (используется по-умолчанию при отсутствии параметра format)
- format=jsonp&funcName=someName - результат в формате JSONP с именем функции someName (при отсутствии параметра funcName имя функции будет pinator)
Примеры запросов и ответов
-
Запрос: http://pinator.org/api/?method=getRandomQuote&format=json
Вариант ответа:
{"id":1011,"url":"http:\/\/pinator.org\/1011","quote":"\u041a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0443\u0434\u0430\u0447\u043d\u044b\u0445 \u0441\u043e\u0431\u044b\u0442\u0438\u0439 \u043d\u0430 \u0432\u0430\u0448\u0435\u043c \u043f\u0443\u0442\u0438, \u0437\u0430\u0432\u0438\u0441\u0438\u0442 \u043e\u0442 \u0432\u0430\u0448\u0435\u0433\u043e \u0436\u0435\u043b\u0430\u043d\u0438\u044f \u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c.","author":"\u0411\u0430\u0440\u0431\u0430\u0440\u0430 \u0428\u0435\u0440"} -
Запрос: http://pinator.org/api/?method=getRandomQuote&format=jsonp&funcName=myFunction
Вариант ответа:
myFunction({"id":1568,"url":"http:\/\/pinator.org\/1568","quote":"\u0412\u0441\u0435, \u0447\u0435\u0433\u043e \u0432\u044b \u0445\u043e\u0442\u0438\u0442\u0435 \u0434\u043e\u0431\u0438\u0442\u044c\u0441\u044f, \u043d\u0430\u0445\u043e\u0434\u0438\u0442\u0441\u044f \u043f\u043e \u0442\u0443 \u0441\u0442\u043e\u0440\u043e\u043d\u0443 \u0441\u0442\u0440\u0430\u0445\u0430.","author":""})
Параметры ответа
id - идентификатор пинатора
url - ссылка на страницу пинатора
quote - текст пинатора (utf8)
author - автор пинатора (utf8)