FIfireant
Surveys

Khảo sát duy nhất nên mời người dùng làm lúc này (banner / bottom sheet)

Changed on

Server chọn theo quy tắc: đang hiệu lực, đúng đối tượng, displayMode Banner (1) hoặc Prompt (2), chưa trả lời, chưa bỏ qua (Để sau còn hạn / Không quan tâm). Thứ tự ưu tiên: đang có bản nháp (hasDraft) -> priority cao -> sắp hết hạn -> mới publish. Client dùng displayMode để quyết định hiện banner hay bottom sheet, dismissible để hiện nút "Để sau" / "Không quan tâm". Khách chưa đăng nhập truyền anonymousId: nhận khảo sát ẩn danh hoặc khảo sát yêu cầu đăng nhập có showToGuests = true (client hiện "Đăng nhập để tham gia" khi isAnonymous = false).

get/surveys/next

Request

Query parameters

anonymousIdstring

Định danh khách ẩn danh (khi chưa đăng nhập)

platformstring

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

appVersionstring

Phiên bản ứng dụng (x.y.z)

targetAudiencestring

Tag tự do

targetTypestring

Tùy chọn: chọn khảo sát cho đối tượng cụ thể (post, symbol, room...). Không truyền = lời mời chung, loại khảo sát có gắn đối tượng

targetKeystring

Khóa đối tượng đi cùng targetType

Response

Khảo sát nên hiển thị

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