feat: 添加媒体资产上传初始化和完成相关API接口及数据结构
This commit is contained in:
@@ -939,6 +939,93 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"/t/{tenantCode}/v1/admin/media_assets/upload_init": {
|
||||
"post": {
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"Tenant"
|
||||
],
|
||||
"summary": "初始化媒体资源上传（租户管理）",
|
||||
"parameters": [
|
||||
{
|
||||
"type": "string",
|
||||
"description": "Tenant Code",
|
||||
"name": "tenantCode",
|
||||
"in": "path",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"description": "Form",
|
||||
"name": "form",
|
||||
"in": "body",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"$ref": "#/definitions/dto.AdminMediaAssetUploadInitForm"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/dto.AdminMediaAssetUploadInitResponse"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/t/{tenantCode}/v1/admin/media_assets/{assetID}/upload_complete": {
|
||||
"post": {
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"Tenant"
|
||||
],
|
||||
"summary": "确认上传完成并进入处理（租户管理）",
|
||||
"parameters": [
|
||||
{
|
||||
"type": "string",
|
||||
"description": "Tenant Code",
|
||||
"name": "tenantCode",
|
||||
"in": "path",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"type": "integer",
|
||||
"format": "int64",
|
||||
"description": "AssetID",
|
||||
"name": "assetID",
|
||||
"in": "path",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"description": "Form",
|
||||
"name": "form",
|
||||
"in": "body",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/dto.AdminMediaAssetUploadCompleteForm"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/models.MediaAsset"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/t/{tenantCode}/v1/admin/orders": {
|
||||
"get": {
|
||||
"consumes": [
|
||||
@@ -2701,6 +2788,91 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminMediaAssetUploadCompleteForm": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"content_type": {
|
||||
"description": "ContentType is the MIME type observed during upload; optional.\nServer may record it for audit and later processing decisions.",
|
||||
"type": "string"
|
||||
},
|
||||
"etag": {
|
||||
"description": "ETag is the storage returned ETag (or similar checksum); optional.\nUsed for audit/debugging and later integrity verification.",
|
||||
"type": "string"
|
||||
},
|
||||
"file_size": {
|
||||
"description": "FileSize is the uploaded object size in bytes; optional.\nServer records it for quota/audit and later validation.",
|
||||
"type": "integer"
|
||||
},
|
||||
"sha256": {
|
||||
"description": "SHA256 is the hex-encoded sha256 of the uploaded object; optional.\nServer records it for integrity checks/deduplication.",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminMediaAssetUploadInitForm": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"content_type": {
|
||||
"description": "ContentType is the MIME type reported by the client (e.g. video/mp4); optional.\nServer should not fully trust it, but can use it as a hint for validation/logging.",
|
||||
"type": "string"
|
||||
},
|
||||
"file_size": {
|
||||
"description": "FileSize is the expected file size in bytes; optional.\nUsed for quota/limit checks and audit; client may omit when unknown.",
|
||||
"type": "integer"
|
||||
},
|
||||
"sha256": {
|
||||
"description": "SHA256 is the hex-encoded sha256 of the file; optional.\nUsed for deduplication/audit; server may validate it later during upload-complete.",
|
||||
"type": "string"
|
||||
},
|
||||
"type": {
|
||||
"description": "Type is the media asset type (video/audio/image).\nUsed to decide processing pipeline and validation rules; required.",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminMediaAssetUploadInitResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"asset_id": {
|
||||
"description": "AssetID is the created media asset id.",
|
||||
"type": "integer"
|
||||
},
|
||||
"bucket": {
|
||||
"description": "Bucket is the target bucket/container; for debugging/audit (may be empty in stub mode).",
|
||||
"type": "string"
|
||||
},
|
||||
"expires_at": {
|
||||
"description": "ExpiresAt indicates when UploadURL/FormFields expire; optional.",
|
||||
"type": "string"
|
||||
},
|
||||
"form_fields": {
|
||||
"description": "FormFields are form fields required for multipart form upload (S3 POST policy); optional.",
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"headers": {
|
||||
"description": "Headers are additional headers required for upload (e.g. signed headers); optional.",
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"object_key": {
|
||||
"description": "ObjectKey is the server-generated object key/path; client must NOT choose it.",
|
||||
"type": "string"
|
||||
},
|
||||
"provider": {
|
||||
"description": "Provider is the storage provider identifier (e.g. s3/minio/oss/local); for debugging/audit.",
|
||||
"type": "string"
|
||||
},
|
||||
"upload_url": {
|
||||
"description": "UploadURL is the URL the client should upload to (signed URL or service endpoint).",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminOrderDetail": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
|
||||
@@ -933,6 +933,93 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"/t/{tenantCode}/v1/admin/media_assets/upload_init": {
|
||||
"post": {
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"Tenant"
|
||||
],
|
||||
"summary": "初始化媒体资源上传（租户管理）",
|
||||
"parameters": [
|
||||
{
|
||||
"type": "string",
|
||||
"description": "Tenant Code",
|
||||
"name": "tenantCode",
|
||||
"in": "path",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"description": "Form",
|
||||
"name": "form",
|
||||
"in": "body",
|
||||
"required": true,
|
||||
"schema": {
|
||||
"$ref": "#/definitions/dto.AdminMediaAssetUploadInitForm"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/dto.AdminMediaAssetUploadInitResponse"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/t/{tenantCode}/v1/admin/media_assets/{assetID}/upload_complete": {
|
||||
"post": {
|
||||
"consumes": [
|
||||
"application/json"
|
||||
],
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
"tags": [
|
||||
"Tenant"
|
||||
],
|
||||
"summary": "确认上传完成并进入处理（租户管理）",
|
||||
"parameters": [
|
||||
{
|
||||
"type": "string",
|
||||
"description": "Tenant Code",
|
||||
"name": "tenantCode",
|
||||
"in": "path",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"type": "integer",
|
||||
"format": "int64",
|
||||
"description": "AssetID",
|
||||
"name": "assetID",
|
||||
"in": "path",
|
||||
"required": true
|
||||
},
|
||||
{
|
||||
"description": "Form",
|
||||
"name": "form",
|
||||
"in": "body",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/dto.AdminMediaAssetUploadCompleteForm"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"schema": {
|
||||
"$ref": "#/definitions/models.MediaAsset"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/t/{tenantCode}/v1/admin/orders": {
|
||||
"get": {
|
||||
"consumes": [
|
||||
@@ -2695,6 +2782,91 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminMediaAssetUploadCompleteForm": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"content_type": {
|
||||
"description": "ContentType is the MIME type observed during upload; optional.\nServer may record it for audit and later processing decisions.",
|
||||
"type": "string"
|
||||
},
|
||||
"etag": {
|
||||
"description": "ETag is the storage returned ETag (or similar checksum); optional.\nUsed for audit/debugging and later integrity verification.",
|
||||
"type": "string"
|
||||
},
|
||||
"file_size": {
|
||||
"description": "FileSize is the uploaded object size in bytes; optional.\nServer records it for quota/audit and later validation.",
|
||||
"type": "integer"
|
||||
},
|
||||
"sha256": {
|
||||
"description": "SHA256 is the hex-encoded sha256 of the uploaded object; optional.\nServer records it for integrity checks/deduplication.",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminMediaAssetUploadInitForm": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"content_type": {
|
||||
"description": "ContentType is the MIME type reported by the client (e.g. video/mp4); optional.\nServer should not fully trust it, but can use it as a hint for validation/logging.",
|
||||
"type": "string"
|
||||
},
|
||||
"file_size": {
|
||||
"description": "FileSize is the expected file size in bytes; optional.\nUsed for quota/limit checks and audit; client may omit when unknown.",
|
||||
"type": "integer"
|
||||
},
|
||||
"sha256": {
|
||||
"description": "SHA256 is the hex-encoded sha256 of the file; optional.\nUsed for deduplication/audit; server may validate it later during upload-complete.",
|
||||
"type": "string"
|
||||
},
|
||||
"type": {
|
||||
"description": "Type is the media asset type (video/audio/image).\nUsed to decide processing pipeline and validation rules; required.",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminMediaAssetUploadInitResponse": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"asset_id": {
|
||||
"description": "AssetID is the created media asset id.",
|
||||
"type": "integer"
|
||||
},
|
||||
"bucket": {
|
||||
"description": "Bucket is the target bucket/container; for debugging/audit (may be empty in stub mode).",
|
||||
"type": "string"
|
||||
},
|
||||
"expires_at": {
|
||||
"description": "ExpiresAt indicates when UploadURL/FormFields expire; optional.",
|
||||
"type": "string"
|
||||
},
|
||||
"form_fields": {
|
||||
"description": "FormFields are form fields required for multipart form upload (S3 POST policy); optional.",
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"headers": {
|
||||
"description": "Headers are additional headers required for upload (e.g. signed headers); optional.",
|
||||
"type": "object",
|
||||
"additionalProperties": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"object_key": {
|
||||
"description": "ObjectKey is the server-generated object key/path; client must NOT choose it.",
|
||||
"type": "string"
|
||||
},
|
||||
"provider": {
|
||||
"description": "Provider is the storage provider identifier (e.g. s3/minio/oss/local); for debugging/audit.",
|
||||
"type": "string"
|
||||
},
|
||||
"upload_url": {
|
||||
"description": "UploadURL is the URL the client should upload to (signed URL or service endpoint).",
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"dto.AdminOrderDetail": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
|
||||
@@ -249,6 +249,89 @@ definitions:
|
||||
description: UserID 目标用户ID。
|
||||
type: integer
|
||||
type: object
|
||||
dto.AdminMediaAssetUploadCompleteForm:
|
||||
properties:
|
||||
content_type:
|
||||
description: |-
|
||||
ContentType is the MIME type observed during upload; optional.
|
||||
Server may record it for audit and later processing decisions.
|
||||
type: string
|
||||
etag:
|
||||
description: |-
|
||||
ETag is the storage returned ETag (or similar checksum); optional.
|
||||
Used for audit/debugging and later integrity verification.
|
||||
type: string
|
||||
file_size:
|
||||
description: |-
|
||||
FileSize is the uploaded object size in bytes; optional.
|
||||
Server records it for quota/audit and later validation.
|
||||
type: integer
|
||||
sha256:
|
||||
description: |-
|
||||
SHA256 is the hex-encoded sha256 of the uploaded object; optional.
|
||||
Server records it for integrity checks/deduplication.
|
||||
type: string
|
||||
type: object
|
||||
dto.AdminMediaAssetUploadInitForm:
|
||||
properties:
|
||||
content_type:
|
||||
description: |-
|
||||
ContentType is the MIME type reported by the client (e.g. video/mp4); optional.
|
||||
Server should not fully trust it, but can use it as a hint for validation/logging.
|
||||
type: string
|
||||
file_size:
|
||||
description: |-
|
||||
FileSize is the expected file size in bytes; optional.
|
||||
Used for quota/limit checks and audit; client may omit when unknown.
|
||||
type: integer
|
||||
sha256:
|
||||
description: |-
|
||||
SHA256 is the hex-encoded sha256 of the file; optional.
|
||||
Used for deduplication/audit; server may validate it later during upload-complete.
|
||||
type: string
|
||||
type:
|
||||
description: |-
|
||||
Type is the media asset type (video/audio/image).
|
||||
Used to decide processing pipeline and validation rules; required.
|
||||
type: string
|
||||
type: object
|
||||
dto.AdminMediaAssetUploadInitResponse:
|
||||
properties:
|
||||
asset_id:
|
||||
description: AssetID is the created media asset id.
|
||||
type: integer
|
||||
bucket:
|
||||
description: Bucket is the target bucket/container; for debugging/audit (may
|
||||
be empty in stub mode).
|
||||
type: string
|
||||
expires_at:
|
||||
description: ExpiresAt indicates when UploadURL/FormFields expire; optional.
|
||||
type: string
|
||||
form_fields:
|
||||
additionalProperties:
|
||||
type: string
|
||||
description: FormFields are form fields required for multipart form upload
|
||||
(S3 POST policy); optional.
|
||||
type: object
|
||||
headers:
|
||||
additionalProperties:
|
||||
type: string
|
||||
description: Headers are additional headers required for upload (e.g. signed
|
||||
headers); optional.
|
||||
type: object
|
||||
object_key:
|
||||
description: ObjectKey is the server-generated object key/path; client must
|
||||
NOT choose it.
|
||||
type: string
|
||||
provider:
|
||||
description: Provider is the storage provider identifier (e.g. s3/minio/oss/local);
|
||||
for debugging/audit.
|
||||
type: string
|
||||
upload_url:
|
||||
description: UploadURL is the URL the client should upload to (signed URL
|
||||
or service endpoint).
|
||||
type: string
|
||||
type: object
|
||||
dto.AdminOrderDetail:
|
||||
properties:
|
||||
order:
|
||||
@@ -1838,6 +1921,63 @@ paths:
|
||||
summary: 拒绝加入申请（租户管理）
|
||||
tags:
|
||||
- Tenant
|
||||
/t/{tenantCode}/v1/admin/media_assets/{assetID}/upload_complete:
|
||||
post:
|
||||
consumes:
|
||||
- application/json
|
||||
parameters:
|
||||
- description: Tenant Code
|
||||
in: path
|
||||
name: tenantCode
|
||||
required: true
|
||||
type: string
|
||||
- description: AssetID
|
||||
format: int64
|
||||
in: path
|
||||
name: assetID
|
||||
required: true
|
||||
type: integer
|
||||
- description: Form
|
||||
in: body
|
||||
name: form
|
||||
schema:
|
||||
$ref: '#/definitions/dto.AdminMediaAssetUploadCompleteForm'
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
"200":
|
||||
description: OK
|
||||
schema:
|
||||
$ref: '#/definitions/models.MediaAsset'
|
||||
summary: 确认上传完成并进入处理（租户管理）
|
||||
tags:
|
||||
- Tenant
|
||||
/t/{tenantCode}/v1/admin/media_assets/upload_init:
|
||||
post:
|
||||
consumes:
|
||||
- application/json
|
||||
parameters:
|
||||
- description: Tenant Code
|
||||
in: path
|
||||
name: tenantCode
|
||||
required: true
|
||||
type: string
|
||||
- description: Form
|
||||
in: body
|
||||
name: form
|
||||
required: true
|
||||
schema:
|
||||
$ref: '#/definitions/dto.AdminMediaAssetUploadInitForm'
|
||||
produces:
|
||||
- application/json
|
||||
responses:
|
||||
"200":
|
||||
description: OK
|
||||
schema:
|
||||
$ref: '#/definitions/dto.AdminMediaAssetUploadInitResponse'
|
||||
summary: 初始化媒体资源上传（租户管理）
|
||||
tags:
|
||||
- Tenant
|
||||
/t/{tenantCode}/v1/admin/orders:
|
||||
get:
|
||||
consumes:
|
||||
|
||||
Reference in New Issue
Block a user