Surveys

Chi tiết khảo sát kèm câu hỏi, lựa chọn và điều kiện rẽ nhánh

Changed on

Câu hỏi loại Section dùng để chia nhóm / ngắt trang. Mỗi câu hỏi có thể có conditions: client chỉ hiển thị câu hỏi khi các điều kiện (kết hợp theo conditionLogic) thỏa trên câu trả lời của câu nguồn. Lựa chọn của câu hỏi có randomizeOptions đã được xáo thứ tự. Khảo sát cho phép ẩn danh có thể gọi không cần token (truyền anonymousId để tính hasResponded / hasDraft). Khảo sát yêu cầu đăng nhập nhưng showToGuests = true cũng đọc được khi chưa đăng nhập (chỉ xem; lưu nháp / gửi trả 401). Trả 403 nếu người dùng không thuộc đối tượng của khảo sát.

get/surveys/{surveyId}

Request

Path parameters

surveyIdinteger required

ID khảo sát

Query parameters

anonymousIdstring

Định danh khách ẩn danh (tùy chọn)

platformstring

Nền tảng: ios | android | web

appVersionstring

Phiên bản ứng dụng

targetAudiencestring

Tag tự do

Response

Thành công

surveyIdinteger

ID khảo sát

codestring

Mã/slug khảo sát (tùy chọn)

titlestring

Tiêu đề

descriptionstring

Mô tả

thankYouMessagestring

Lời cảm ơn hiển thị sau khi gửi

imageUrlstring

Ảnh minh họa

status0 | 1 | 2 | 3

Trạng thái (0 = Draft, 1 = Published, 2 = Closed, 3 = Archived)

isAnonymousboolean

Cho phép trả lời không cần đăng nhập

allowMultipleResponsesboolean

Cho phép một người trả lời nhiều lần

showResultsboolean

Cho phép người trả lời xem kết quả tổng hợp

startDatestring date-time

Thời điểm bắt đầu nhận phản hồi (null = ngay khi publish)

endDatestring date-time

Thời điểm kết thúc nhận phản hồi (null = không giới hạn)

maxResponsesinteger

Số phản hồi tối đa (null = không giới hạn)

targetAudiencestring

Nhóm đối tượng (all, premium, ios, android...)

priorityinteger

Ưu tiên hiển thị (cao hơn lên trước)

displayMode0 | 1 | 2

Cách hiển thị trên App/Web: 0 ListOnly, 1 Banner, 2 Prompt (0 = ListOnly, 1 = Banner, 2 = Prompt)

dismissibleboolean

Cho phép người dùng "Để sau" / "Không quan tâm"

snoozeDaysinteger

Số ngày ẩn khảo sát khi người dùng chọn "Để sau"

showToGuestsboolean

Khảo sát yêu cầu đăng nhập vẫn hiện với khách chưa đăng nhập (client mời đăng nhập khi bấm vào)

presentationMode0 | 1 | 2

Chế độ trình bày: 0 cuộn một trang, 1 mỗi Section một trang, 2 mỗi câu một màn hình (0 = Scroll, 1 = SectionPages, 2 = OneByOne)

isDismissedboolean

Người dùng hiện tại đang bỏ qua khảo sát này (Để sau còn hạn hoặc Không quan tâm)

dismissedUntilstring date-time

Ẩn đến thời điểm này (null nếu không bỏ qua hoặc ẩn hẳn)

dismissCountinteger

Số người đã bỏ qua khảo sát (admin)

targetCountinteger

Số đối tượng khảo sát được gắn vào (0 = khảo sát chung)

targetSummarystring

Tóm tắt đối tượng gắn kèm cho admin, ví dụ "symbol:FPT, post:40203799"

questionCountinteger

Số câu hỏi

responseCountinteger

Số phản hồi đã nhận

hasRespondedboolean

Người dùng hiện tại đã trả lời khảo sát này chưa

hasDraftboolean

Người dùng hiện tại đang có bản nháp chưa gửi

draftCountinteger

Số bản nháp đang tồn tại (admin)

isActiveboolean

Khảo sát đang trong thời gian nhận phản hồi

createdBystring

Người tạo

createdDatestring date-time

Ngày tạo

updatedBystring

Người cập nhật cuối

updatedDatestring date-time

Ngày cập nhật cuối

publishedDatestring date-time

Ngày publish

closedDatestring date-time

Ngày đóng

isDeletedboolean

Đã xóa mềm

Changes