Посещения и публичные ссылки

Посещения опроса

128. Посещения по источникам, устройствам, браузерам и странам

В API с 13.10.2026

Разбивает посещения опроса по одному признаку: значению параметра ссылки (utm_source, utm_campaign, любая скрытая переменная), устройству, браузеру или стране.

GET/quiz/{id}/summary/segments

Право: просмотр результатов опроса.

GET /quiz/18197/summary/segments?by=param&key=utm_source&date_from=2026-09-14&date_to=2026-10-13

Пример ответа (200)

{
    "status": true,
    "rows": [
        { "value": "email", "opens": 230, "unique_browsers": 223, "with_answer": 152, "completed": 111 },
        { "value": "", "opens": 3, "unique_browsers": 3, "with_answer": 1, "completed": 0 },
        { "value": null, "opens": 24, "unique_browsers": 24, "with_answer": 18, "completed": 14 }
    ],
    "truncated": false
}

Порядок — по opens от большего, строка null всегда последняя. Строк не больше 200, строка null входит в это число. Если в опросе включены анонимные ответы, разбивка по устройству, браузеру и стране приходит пустой; по параметру ссылки — как обычно.

Ошибки

129. Журнал посещений

В API с 13.10.2026

Посещения опроса, сначала новые: когда, на чём, с какими параметрами ссылки и что с посещением стало.

GET/quiz/{id}/summary/visits

Право: просмотр результатов опроса.

GET /quiz/18197/summary/visits?status=no_answer&segment_by=device&segment_value=mobile

Пример ответа (200)

{
    "status": true,
    "total": 230,
    "counts": { "all": 230, "no_answer": 78, "started": 152, "completed": 111, "unfinished": 31, "screenout": 10 },
    "items": [
        {
            "id": 99102,
            "created_at": "2026-10-13T20:57:00+03:00",
            "device": "desktop",
            "browser": "Chrome",
            "country": "Russia",
            "params": { "utm_source": "email", "utm_medium": "social" },
            "status": "completed",
            "answer_id": 55120
        }
    ]
}

Ошибки

Публичные ссылки на результаты

130. Список публичных ссылок раздела

В API с 13.10.2026

Самые новые ссылки на сводку, отчёт или ответы опроса — вместе с выключенными. Нужно право участника view_results.

GET/quiz/{id}/shared/{section}

section — summary, report или answers. Другое значение — 404.

Пример ответа (200)

{
    "status": true,
    "total": 3,
    "items": [
        {
            "uuid": "9f1c2e7a-4b6d-3c8e-a1b2-c3d4e5f60718",
            "number": 3,
            "url": "https://api.webask.io/b33f5he82/answers/9f1c2e7a-4b6d-3c8e-a1b2-c3d4e5f60718",
            "created_at": "2026-10-13T01:02:00+03:00",
            "is_active": true,
            "answers_count": 2
        }
    ]
}

В список answers входят ссылки на все ответы и на выбранные ответы. Ссылки респондентов на свой ответ со страницы завершения и ссылки «все, кроме выбранных» (type: not_in) не входят и не считаются в total и number.

Ошибки

131. Выключить или включить публичную ссылку

В API с 13.10.2026

Выключенная ссылка перестаёт открываться: публичная страница отвечает так же, как на ссылку, которой нет, данные результатов не отдаются. Ссылка не удаляется — остаётся в списке §130 с is_active: false, её можно включить обратно. Нужно право участника view_results.

PATCH/quiz/{id}/shared/{section}/{uuid}

Тело запроса

{ "is_active": false }

Повторный вызов с тем же значением ничего не меняет и отвечает 200.

Пример ответа (200)

{
    "status": true,
    "link": {
        "uuid": "9f1c2e7a-4b6d-3c8e-a1b2-c3d4e5f60718",
        "number": 3,
        "url": "https://api.webask.io/b33f5he82/summary/9f1c2e7a-4b6d-3c8e-a1b2-c3d4e5f60718",
        "created_at": "2026-10-13T01:02:00+03:00",
        "is_active": false
    }
}

link — ссылка в том же виде, что в списке §130.

Ошибки