Модуль опроса. API: відмінності між версіями

Матеріал з NoDeny
Перейти до навігації Перейти до пошуку
Немає опису редагування
Рядок 62: Рядок 62:
     --cookie 'noses=zpP6gc2lJjeYKzskLBK7zA'
     --cookie 'noses=zpP6gc2lJjeYKzskLBK7zA'
</source>
</source>
==Коды ошибок==
<pre>
temporary        : ошибка на сервере API
poll_id_required : в параметре poll_id не задан id опроса
poll_not_found  : опрос не найден (неверный id/опрос переведен в статус "неактивный"/
                                  время опроса еще не наступило или уже закончилось)
choice_required  : в параметре choices не указан ни один пункт опроса
only_one_choice  : опрос позволяет выбирать только один пункт
cannot_revote    : пользоваттель уже голосовал и в данном опросе не разрешено менять выбор
</pre>

Версія за 13:58, 30 липня 2021

Список опросов

curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_poll&cmd=list' \
    --cookie 'noses=zpP6gc2lJjeYKzskLBK7zA'

Если в ответе ключ err_cod - ошибка. Иначе в polls - список опросов.

Данные опроса:

id                : id опроса, целое число больше нуля
title             : заголовок
description       : описание
start_date        : дата старта опроса в виде строки
end_date          : дата завершения опроса в виде строки
start             : дата старта опроса в виде timestamp
end               : дата завершения опроса в виде timestamp
stats_voted_users :  количество проголосовавших
can_see_results   : 1 - пользователь может видеть результаты голосования, 0 - нет
can_see_results_before_vote : 1 - может видеть результаты до голосования, 0 - только после
can_revote        : 1 - может переголосовать, 0 - нет
can_multi_choice  : 1 - можно голосовать за несколько пунктов, 0 - нет
voted             : 1 - голосовал, 0 - нет
can_anonymous     : 1 - можно голосовать анонимно, 0 - нет
vote_time         : дата голосования в виде строки, '' если не голосовал
viewed_time       : дата первого просмотра опроса в виде строки, '' если не просматривал еще
ignore            : пользователь просил не показываеть ему этот опрос
  • Если не разрешено просматривать результаты опроса или пользователь не голосовал, то stats_voted_users = -1.
  • ignore - флаг, который указывает на то, что ранее пользователь давал команду не показывать этот опрос. Показывать или нет - на усмотрение.

Получить данные опроса

В параметре poll_id - id опроса по таблице polls

curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_poll&cmd=choices&poll_id=1' \
    --cookie 'noses=zpP6gc2lJjeYKzskLBK7zA'

Если в ответе ключ err_cod - ошибка. Иначе в choices - пункты опроса.

id          : id пункта  опроса
title       : пункт опроса
voted       : 1 - проголосовал за этот пункт
description : описание
votes       : количество проголосовавших за этот пункт
  • Если не разрешено просматривать результаты опроса или пользователь не голосовал, то votes = -1.

Игнорировать опрос

curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_poll&cmd=ignore&poll_id=1' \
    --cookie 'noses=zpP6gc2lJjeYKzskLBK7zA'

Не игнорировать опрос

curl 'http://app.nodeny-plus.com.ua/cgi-bin/noapi.pl?a=u_poll&cmd=dont_ignore&poll_id=1' \
    --cookie 'noses=zpP6gc2lJjeYKzskLBK7zA'

Коды ошибок

temporary        : ошибка на сервере API
poll_id_required : в параметре poll_id не задан id опроса
poll_not_found   : опрос не найден (неверный id/опрос переведен в статус "неактивный"/
                                  время опроса еще не наступило или уже закончилось)
choice_required  : в параметре choices не указан ни один пункт опроса
only_one_choice  : опрос позволяет выбирать только один пункт
cannot_revote    : пользоваттель уже голосовал и в данном опросе не разрешено менять выбор