POST `/internal/identity/link-saml-user`

内部API：根据 SAML assertion 关联已存在用户或创建新用户，供 saml-service 调用。需InternalAPIKeyAuth认证。

身份认证 None application/json

请求体

Schema： service-identity/internal/handler/dto.LinkSAMLUserRequest

字段	类型	必填	示例	约束	描述
`name_id`	`string`	是
`provider_id`	`string`	是
`email`	`string`	否			Email 与 UserID 至少一个（AUTH-12：SAML 已链接路径按 user_id 解析）。
`name`	`string`	否
`tenant_id`	`string`	否			显式租户；空 → X-Tenant-ID
`user_id`	`string`	否

响应

状态	描述	Schema
200	关联结果	`service-core/base/dto.DataResponse-service-identity/internal/handler/dto/LinkSAMLUserResponse`

引用的 Schema

service-core/base/dto.DataResponse-service-identity/internal/handler/dto/LinkSAMLUserResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-identity/internal/handler/dto.LinkSAMLUserResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-identity/internal/handler/dto.LinkSAMLUserResponse

字段	类型	必填	示例	约束	描述
`is_new`	`boolean`	否
`status`	`string`	否			AUTH-12：active/pending/...；saml-service 据此拒绝非 active
`tenant_id`	`string`	否			解析所用租户（调用方校验与 provider 租户一致）
`user_id`	`string`	否

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓