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
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 |