GET `/communication/providers`

分页查询当前租户的服务商配置列表。支持按渠道（sms/email/push）和激活状态筛选。配置凭据在响应中自动脱敏（显示为***REDACTED***）。参考：ePrivacy Directive 2002/58/EC、CAN-SPAM Act。

通信服务 `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
`channel`	`query`	`string`	No				渠道筛选：sms/email/push
`is_active`	`query`	`boolean`	No				激活状态筛选：true/false
`page`	`query`	`integer`	No				页码，从1开始（默认1）
`page_size`	`query`	`integer`	No				每页条数（默认20）

Responses

Status	Description	Schema
200	查询成功，返回配置列表（凭据已脱敏）	`dto.ListResponse-dto_ProviderConfigResponse`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
403	无权访问该资源	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

Referenced Schemas

dto.ListResponse-dto_ProviderConfigResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`items`	array of See `dto.ProviderConfigResponse`	No			统一使用 items
`message`	`string`	No
`pagination`	`object`	No			分页信息（嵌套对象）
`timestamp`	`string`	No
`total`	`integer`	No			总条数（平铺，便于直接读取）

dto.PageInfo

Field	Type	Required	Example	Constraints	Description
`has_next`	`boolean`	No			HasNext indicates whether there is a next page
`has_prev`	`boolean`	No			HasPrev indicates whether there is a previous page
`page`	`integer`	No			Page is the current page number (1-based)
`page_size`	`integer`	No			PageSize is the number of items per page
`total`	`integer`	No			Total is the total number of items across all pages
`total_pages`	`integer`	No			TotalPages is the total number of pages

dto.ProviderConfigResponse

Field	Type	Required	Example	Constraints	Description
`app_id`	`string`	No
`channel`	`string`	No
`config`	`string`	No
`created_at`	`string`	No
`id`	`string`	No
`is_active`	`boolean`	No
`priority`	`integer`	No
`provider`	`string`	No
`tenant_id`	`string`	No
`updated_at`	`string`	No

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

↑