GET /admin/compliance/legal-documents

分页查询协议文档(管理端可见全部状态 draft/published/archived),支持 doc_type 筛选。include_content=false 时列表项不返回 content 键(瘦载荷);缺省 true(与历史行为一致)。

合规管理 - 协议文档 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
doc_type query string 否 doc type filter (terms/privacy)
page query integer 否 page number
page_size query integer 否 page size
include_content query boolean 否 include legal document content in list items (default true)

响应

引用的 Schema

service-compliance/internal/handler/dto.ErrorResponse

字段类型必填示例约束描述
code integer 否 400
message string 否 invalid request

service-compliance/internal/handler/dto.LegalDocumentItem

字段类型必填示例约束描述
content string 否 [{"title":"1. 引言","body":"..."}]
doc_type string 否 terms
effective_at string 否 2026-06-09T00:00:00Z
id string 否 01JQ...
lang string 否 zh-CN
status string 否 published
tenant_id string 否
title string 否 服务条款
version string 否 v1

service-compliance/internal/handler/dto.ListLegalDocumentsResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-compliance/internal/handler/dto.LegalDocumentItem

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages