Zoznam operácií pre zdroj
Názov | URL | Popis |
---|---|---|
Zoznam otázok | /questions/:id_survey/:id_page | Vracia zoznam otázok pre dotazník daného ID. |
Opis parametrov odpovede
Názov/cesta | Popis | Možné hodnoty |
---|---|---|
id | ID otázky | |
id_page | ID stránky s otázkou | |
number | Číslo otázky | |
type | Typ otázky | 0 - Otázka s jednou možnosťou výberu |
date_created | Dátum vytvorenia otázky | |
date_modified | Dátum poslednej editácie otázky | |
text | Obsah otázky | |
desc | Popis otázky | |
required | Príznak označujúci či je otázka povinná alebo nie |
|
answers_count | Počet odpovedí v otázke | |
options.long_answer | Príznak, označujúci či by popisová otázka mala mať miesto pre dlhší text odpovede, alebo nie. Parameter je viditeľný len pre popisové otázky | true - Dlhý text odpovede |
options.min | V otázkach s viacerými možnosťami výberu: minimálny počet vybraných odpovedí V otázkach na dátum: najvzdialenejšie možný dátum k výberu pri vypĺňaní V otázkach na číslo: minimálna možná hodnota pri vypĺňaní Ak nie je hodnota definovaná, bude vrátený null | 0 - Číslo v danom formáte |
options.max | V otázkach s viacerými možnosťami výberu: maximálny počet vybraných odpovedí V otázkach na dátum: najbližší možný dátum k výberu pri vypĺňaní V otázkach na číslo: maximálna možná hodnota pri vypĺňaní Ak nie je hodnota definovaná, bude vrátený null | 0 - Číslo v danom formáte |
options.shuffle_answers | Príznak, označujúci či má byť poradie odpovedí náhodné. Táto náhodná prezentácia by mala byť vykonaná na strane aplikácie klienta. Nehľadiac na tento príznak, API bude vždy vracať odpovede v rovnakom poradí. Informácie dostupné pre nasledujúce otázky: Otázka s jednou možnosťou výberu, Otázka s viacerými možnosťami výberu, Maticová otázka s jednou možnosťou výberu, Maticová otázka s viacerými možnosťami výberu, rankingové otázka, Formulár, Otázka s posuvníkom (stupnice), Roletka, Otázka uchopiť a presunúť | true - Náhodné poradie odpovedí |
options.horizontal_display | Príznak, označujúci či majú byť odpovede zobrazené vedľa seba (horizontálne orientácia odpovedí). Informácie dostupné pre nasledujúce otázky: Otázka s jednou možnosťou výberu a Otázka s viacerými možnosťami výberu. | true - Horizontálna orientácia odpovedí |
options.range_positions_number | Počet pozícií posuvníka. Táto možnosť je dostupná iba pre otázky s posuvníkom. | |
answers.* | Odpovede v otázke. Pole je dostupné pre nasledujúce otázky: Otázka s jednou možnosťou výberu, Otázka s viacerými možnosťami výberu, Maticová otázka s jednou možnosťou výberu, Maticová otázka s viacerými možnosťami výberu, rankingové otázky, formulár, roletka, otázka uchopiť a presunúť | Array |
answers.text | Obsah odpovede | |
answers.custom_response_available | Príznak, označujúci či môže byť odpoveď aj „používateľská” | true - Užívateľská odpoveď dostupná |
answers.required | Príznak, označujúci či je alebo nie je vyplnenie odpovede povinné. Parameter je dostupný pre formulár. | true - Vyplnenie poľa formulára je povinné |
scales.* | Nasledujúce polohy mierky (nastavenie rozsahu) sú k dispozícii v nasledujúcich otázkach: Maticová otázka s jednou možnosťou výberu, maticová otázka s viacerými možnosťami výberu, Otázka uchopiť a presunúť | Array |
scales.text | Obsah etikety mierky | |
ranges.* | Krajné štítky z mierky sú povolené len pre otázku so stupnicou (posuvníkom) | Array |
ranges.left | Text na ľavej strane od stupnice | |
ranges.right | Text na pravej strane od stupnice |
Zoznam otázok
URL
(GET) https://www.netquest.sk/api/questions/:id_survey/:id_page
Parametre (GET)
Názov | Popis |
---|---|
id_survey | ID dotazníka obsahujúce otázky. povinný parameter |
id_page | ID stránky obsahujúcej otázky. Stránka musí spadať pod dotazník (id_survey). nepovinný parameter |
Ukážka odpovede
[ { "id":782299, "id_page":258355, "number":1, "type":0, "date_created":"2011-07-14 22:24:46", "date_modified":"2011-12-29 18:04:24", "text":"Otázka s jednou možností výběru", "desc":"", "required":1, "answers_count":3, "options":{ "shuffle_answers":false, "horizontal_display":false }, "answers":[ { "text":"Ano", "custom_response_available":false }, { "text":"Ne", "custom_response_available":false }, { "text":"Jiné", "custom_response_available":true } ] }, { "id":782300, "id_page":258355, "number":2, "type":6, "date_created":"2011-07-14 22:24:58", "date_modified":"2011-12-29 18:04:13", "text":"Otázka s více možnostmi výběru", "desc":"", "required":1, "answers_count":4, "options":{ "min":2, "max":2, "shuffle_answers":false, "horizontal_display":false }, "answers":[ { "text":"Ano", "custom_response_available":false }, { "text":"Ne", "custom_response_available":false }, { "text":"Možná", "custom_response_available":false }, { "text":"Jiné", "custom_response_available":true } ] }, { "id":782301, "id_page":258355, "number":3, "type":1, "date_created":"2011-07-14 22:25:10", "date_modified":"2011-12-29 18:04:04", "text":"Maticová otázka s jednou možností výběru", "desc":"", "required":1, "answers_count":2, "options":{ "shuffle_answers":false }, "answers":[ { "text":"Ola" }, { "text":"Jola" } ], "scales":[ { "text":"Ano" }, { "text":"Ne" } ] }, { "id":782302, "id_page":258355, "number":4, "type":7, "date_created":"2011-07-14 22:25:27", "date_modified":"2011-12-29 18:03:54", "text":"Maticová otázka s více možnostmi výběru", "desc":"Zadejte barvu očí", "required":1, "answers_count":4, "options":{ "shuffle_answers":false }, "answers":[ { "text":"Jana" }, { "text":"Petra" }, { "text":"Alena" }, { "text":"Zuzka" } ], "scales":[ { "text":"Modré" }, { "text":"Zelené" }, { "text":"Hnědé" } ] }, { "id":782303, "id_page":258355, "number":5, "type":2, "date_created":"2011-07-14 22:25:36", "date_modified":null, "text":"Otevřená otázka", "desc":"", "required":1, "answers_count":1, "options":{ "long_answer":false } }, { "id":782304, "id_page":258355, "number":6, "type":5, "date_created":"2011-07-14 22:25:52", "date_modified":null, "text":"Rankingová otázka", "desc":"", "required":1, "answers_count":3, "options":{ "shuffle_answers":true }, "answers":[ { "text":"Jedna" }, { "text":"Dva" }, { "text":"Tri" } ] }, { "id":782305, "id_page":258355, "number":7, "type":4, "date_created":"2011-07-14 22:26:04", "date_modified":"2011-12-29 18:04:59", "text":"Formulár", "desc":"", "required":0, "answers_count":4, "options":{ "shuffle_answers":false }, "answers":[ { "text":"Meno", "required":false }, { "text":"Priezvisko", "required":false }, { "text":"Číslo", "required":true }, { "text":"Telefon", "required":true } ] }, { "id":782306, "id_page":258355, "number":8, "type":8, "date_created":"2011-07-14 22:26:27", "date_modified":null, "text":"Posuvníková otázka", "desc":"", "required":1, "answers_count":2, "options":{ "shuffle_answers":false, "range_positions_number":6 }, "ranges":[ { "left":"Špatné", "right":"Dobré" }, { "left":"Smutné", "right":"Štastné" } ] }, { "id":819543, "id_page":258355, "number":9, "type":13, "date_created":"2011-12-29 16:56:00", "date_modified":null, "text":"Roletka", "desc":"", "required":1, "answers_count":4, "options":{ "shuffle_answers":true }, "answers":[ { "text":"Jedna" }, { "text":"Dva" }, { "text":"Tři" }, { "text":"Štyri" } ] }, { "id":819544, "id_page":258355, "number":10, "type":10, "date_created":"2011-12-29 16:57:27", "date_modified":"2011-12-29 18:03:18", "text":"Numerická otázka", "desc":"Dodatečný popis", "required":1, "answers_count":1, "options":{ "min":null, "max":10 } }, { "id":819545, "id_page":258355, "number":11, "type":11, "date_created":"2011-12-29 16:57:48", "date_modified":null, "text":"Otázka na e-mailovú adresu", "desc":"", "required":1, "answers_count":1 }, { "id":819546, "id_page":258355, "number":12, "type":12, "date_created":"2011-12-29 16:58:07", "date_modified":null, "text":"Datumová otázka", "desc":"", "required":1, "answers_count":1, "options":{ "min":"01-12-2011", "max":"29-02-2012" } }, { "id":1955652, "id_page":258355, "number":13, "type":16, "date_created":"2014-10-04 15:32:36", "date_modified":"2014-10-17 16:36:39", "text":"NPS otázka", "desc":"", "required":1, "answers_count":11, "options":{ "left_scale":"Určite nie", "right_scale":"Určite áno", "justification":"Prosím odôvodnite svoju odpoveď" }, "answers":[ { "text":"0", "custom_response_available":true }, { "text":"1", "custom_response_available":true }, { "text":"2", "custom_response_available":true }, { "text":"3", "custom_response_available":true }, { "text":"4", "custom_response_available":true }, { "text":"5", "custom_response_available":true }, { "text":"6", "custom_response_available":true }, { "text":"7", "custom_response_available":true }, { "text":"8", "custom_response_available":true }, { "text":"9", "custom_response_available":true }, { "text":"10", "custom_response_available":true } ] }, { "id":1955653, "id_page":258355, "number":14, "type":19, "date_created":"2011-07-14 22:25:10", "date_modified":"2011-12-29 18:04:04", "text":"Otázka uchopit a přesunout", "desc":"", "required":1, "answers_count":2, "options":{ "shuffle_answers":false }, "answers":[ { "text":"Morská kúpel" }, { "text":"Lyžovanie na horách" } ], "scales":[ { "text":"Leto" }, { "text":"Zima" } ] }, ]
Chybové hlášky
- 400 Zlá požiadavka – Nekompatibilné parametre, nie je tu žiadna stránka s ID: id_page v dotazníku s ID: id_survey.
- 401 Neautorizovaný – Užívateľ odkázaný na zdroj – dotazník – ktorú nevlastní.
- 404 Nenájdené – Nenašiel sa žiadny dotazník daného: id_survey.
- 406 Neprijateľné – Nebol odovzdaný žiadny parameter: id_survey.