上传信息确认函

POST

/openapi/v3/orders/:id/org-confirm-letter

上传已签署的组织信息确认函。支持 multipart/form-data 文件上传和 Base64 JSON 两种形式。

Path 参数

参数	类型	必填	说明
id	string	是	订单 ID

Query 参数

参数	类型	必填	说明
json	boolean	否	传 true 时使用 JSON Base64 方式上传

Body 参数

• 默认方式：multipart/form-data
• JSON 方式（?json=true）：application/json

参数	类型	必填	说明
letter	file	是	信息确认函文件（doc/png/pdf）。multipart 方式可传 1–2 个同名 letter 字段，请求总大小不超过 5MB
filename	string	否	文件名（JSON 方式；建议传入以保留原始文件名）
file_data	string	是	Base64 编码的文件内容（JSON 方式）

# multipart/form-data 方式
curl -X POST 'https://api.certcloud.cn/openapi/v3/orders/my-order-001/org-confirm-letter' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -F 'letter=@/path/to/confirm-letter.pdf'

# JSON Base64 方式
curl -X POST 'https://api.certcloud.cn/openapi/v3/orders/my-order-001/org-confirm-letter?json=true' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "filename": "confirm-letter.pdf",
    "file_data": "JVBERi0xLjQK..."
  }'

// multipart/form-data 方式
const form = new FormData();
form.append('letter', fileInput.files[0]);
fetch('https://api.certcloud.cn/openapi/v3/orders/my-order-001/org-confirm-letter', {
  method: 'POST',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id'
  },
  body: form
});

// JSON Base64 方式
fetch('https://api.certcloud.cn/openapi/v3/orders/my-order-001/org-confirm-letter?json=true', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id'
  },
  body: JSON.stringify({
    filename: 'confirm-letter.pdf',
    file_data: 'JVBERi0xLjQK...'
  })
});

// multipart/form-data 方式
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("letter", "confirm-letter.pdf")
part.Write(fileBytes)
writer.Close()
req, _ := http.NewRequest("POST", "https://api.certcloud.cn/openapi/v3/orders/my-order-001/org-confirm-letter", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
client := &http.Client{}
resp, _ := client.Do(req)

import requests

# multipart/form-data 方式
requests.post(
    'https://api.certcloud.cn/openapi/v3/orders/my-order-001/org-confirm-letter',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id'
    },
    files={'letter': open('/path/to/confirm-letter.pdf', 'rb')}
)

200成功

{
  "code": "success"
}