上传证书

上传证书至 PBX 的临时存储区域。

注：
  • 调用此接口只会临时存储证书文件，而不会将其添加到 PBX 的证书列表中。要正式添加并使用该证书，你需要再后续调用 添加证书 接口。
  • 系统将于每日凌晨 1:00 自动清理所有上传已超过 1 小时的证书文件。

请求 URL

POST {base_url}/{api_path}/certificate/upload?access_token={access_token}

请求参数

参数 是否必填 类型 说明
file 是 File 所需证书文件，以 form-data 格式上传。
type 是 String 指定证书类型。
取值范围：
  • trusted：受信任证书。
  • server：PBX 服务器证书。

响应参数

表 1.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
file String 证书文件名称。

示例

请求示例

POST /openapi/v1.0/certificate/upload?access_token=wOODrqhysk0aELacF87qd4lBvmbBY4IZ HTTP/1.1
Host: 192.168.5.150:8088

Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="type"

trusted
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="/D:/project/certificate/example.domain.com.crt"
Content-Type: <Content-Type header here>

(data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--
图 1. Postman请求示例

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "file": "example.domain.com.crt"
}