接口详情
- operationId
listPlatformBrandAssets- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
响应
listPlatformBrandAssets 响应| 状态码 | 说明 |
|---|
200 | Asset metadata 字段：schema: const cdnca.platform-brand-asset/v1 assets: array<Asset> |
|---|
401 | Unauthenticated |
|---|
403 | Permission denied |
|---|
失败时怎么办
401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。
↑ 回到列表
- operationId
getPlatformBrandAsset- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
参数
getPlatformBrandAsset 参数| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|
slot | path | string: favicon / logo / login_ad / logo_dark / login_background / app_icon | 是 | — |
|---|
响应
getPlatformBrandAsset 响应| 状态码 | 说明 |
|---|
200 | Asset metadata 字段：schema: const cdnca.platform-brand-asset/v1 slot: string: favicon / logo / login_ad / logo_dark / login_background / app_icon revision: integer reference?: string mime_type?: string size_bytes?: integer sha256?: string updated_at?: string(date-time) |
|---|
401 | Unauthenticated |
|---|
403 | Permission denied |
|---|
失败时怎么办
401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。
↑ 回到列表
- operationId
uploadPlatformBrandAsset- 认证
- 登录会话：主控登录后的 Bearer 会话，由客户本人在自己的主控里使用；插件不能要求客户交出会话。
- 所需权限
契约没有单独标注权限码，权限要求见下方说明与 403 响应。
参数
uploadPlatformBrandAsset 参数| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|
slot | path | string: favicon / logo / login_ad / logo_dark / login_background / app_icon | 是 | — |
|---|
If-Match | header | string | 是 | — |
|---|
Idempotency-Key | header | string | 是 | — |
|---|
X-Request-ID | header | string | 是 | — |
|---|
请求体
image/png, image/jpeg, image/x-icon, image/vnd.microsoft.icon · 必填：是
响应
uploadPlatformBrandAsset 响应| 状态码 | 说明 |
|---|
200 | Uploaded asset 字段：schema: const cdnca.platform-brand-asset/v1 slot: string: favicon / logo / login_ad / logo_dark / login_background / app_icon revision: integer reference?: string mime_type?: string size_bytes?: integer sha256?: string updated_at?: string(date-time) |
|---|
400 | Invalid media or request |
|---|
401 | Unauthenticated |
|---|
403 | Permission denied |
|---|
409 | Revision or idempotency conflict |
|---|
失败时怎么办
400 按字段说明修正参数或请求体再发；不要原样重试。401 检查凭据格式、是否过期或被轮换。403 检查 Key 范围与所有者当前权限、当前租户作用域；不要换更高权限账号绕过。409 先回读资源当前状态；同一操作重试保持原 Idempotency-Key 和原请求内容。
↑ 回到列表