---
title: "POST /v1/admin/invoices/{id}/upload-url"
method: POST
path: "/v1/admin/invoices/{id}/upload-url"
tags: ["AdminInvoiceService"]
---

# POST /v1/admin/invoices/{id}/upload-url

`POST /v1/admin/invoices/{id}/upload-url`

CreateInvoiceFileUploadURL 生成 presigned PUT 直传地址（绕过 admin 代理 multipart 坑，§六）。
 前端 PUT 上传后，把返回的 file_key 传给 IssueInvoice。

## Path parameters

- `id` string, required

## Request body

- AdminInvoiceV1CreateInvoiceFileUploadURLRequest
  - `contentType` string — content_type 内容类型：approved 票允许原票版式/XML；issued 票仅允许红字 PDF/OFD。
  - `filename` string — filename 原始文件名（用于生成 object key，服务端消毒）
  - `id` string

## Response `200`

OK

- AdminInvoiceV1CreateInvoiceFileUploadURLReply
  - `expiresAt` string — expires_at 上传地址失效时间（RFC3339）
  - `fileKey` string — file_key 对象 key；approved 状态返回原票 key，issued 状态返回独立红字版式件 key；上传成功后回填对应开具/红冲接口
  - `requiredHeaders` object — required_headers 直传时必须原样携带的显式签名请求头；不包含由浏览器/HTTP 客户端根据 upload_url 自动管理的 Host。
  - `uploadUrl` string — upload_url presigned PUT 地址（前端直传对象存储）

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)