Cisco Cisco Email Security Appliance C370D User Guide

Cisco AsyncOS API for Email - 入门指南

  AsyncOS API 请求和响应

您可以使用任意 base64 库将您的凭证转换为 base64 编码格式。下表显示了 base64 编码凭证的示例：

注意

编码的凭证在标头中必须位于单独一行。

AsyncOS API 请求和响应

AsyncOS API 请求

对 API 执行的请求具有以下特征：

请求将通过 HTTP 或 HTTPS 发送

每个请求必须包含采用以下格式的有效 URI：

https://{appliance}:{port}/api/v1.0/{resource}?{resource_attributes}

，其中：

{appliance}:{port}

 是设备的 FQDN 或 IP 地址以及设备在其上进行侦听的 TCP 端口号。

{resource}

 是您正尝试访问的资源，例如报告或计数器。

{resource_attributes} 

是资源支持的属性，如持续时间、最长时间等。

每个请求必须包含采用 base64 编码格式的有效 Authorization 标头。

每个请求必须将 Accept 设置为：

application/json

通过 HTTPS 发送的请求 （使用您自己的证书）必须包含您的 CA 证书。例如，如果使用 
cURL，您可以在 API 请求中指定 CA 证书，如下所示：

curl --cacert <ca_cert.crt> -u "username:password" 

https://<fqdn>:<port>/api/v1.0/{resource}?{resource_attributes}

注意

API 请求区分大小写，并且应按照本手册所示进行输入。

项目

值

用户名

administrator

密码

Password$123

凭证

administrator:Password$123

Base64 编码凭证

YWRtaW5pc3RyYXRvcjpQYXNzd29yZCQxMjM=