1. openapi
Certd开放接口文档
  • 介绍
    • Certd开放接口介绍
  • 开放接口
    • openapi
      • 获取证书
        POST
      • 发送通知
        POST
  • 用户级别
    • pipeline-access
      • 查询授权配置分页列表
      • 查询授权配置列表
      • 添加授权配置
      • 更新授权配置
      • 查询授权配置详情
      • 删除授权配置
      • 查询授权插件定义
      • 获取授权配置明文密钥
      • 查询授权类型字典
      • 查询授权配置简单信息
      • 根据ID列表获取授权配置字典
    • pipeline-cname
      • 查询CNAME提供商列表
      • 查询CNAME记录分页列表
      • 查询CNAME记录列表
      • 添加CNAME记录
      • 更新CNAME记录
      • 查询CNAME记录详情
      • 删除CNAME记录
      • 批量删除CNAME记录
      • 根据域名获取CNAME记录
      • 验证CNAME记录
      • 重置CNAME记录状态
      • 导入CNAME记录
    • monitor
      • 查询站点监控分页列表
      • 查询站点监控列表
      • 添加站点监控
      • 更新站点监控
      • 查询站点监控详情
      • 删除站点监控
      • 批量删除站点监控
      • 检查站点监控
      • 检查所有站点监控
      • 导入站点监控
      • 修改IP检查设置
      • 修改禁用状态
      • 获取站点监控设置
      • 保存站点监控设置
      • 查询站点IP分页列表
      • 查询站点IP列表
      • 添加站点IP
      • 更新站点IP
      • 查询站点IP详情
      • 删除站点IP
      • 检查站点IP
      • 检查所有站点IP
      • 同步站点IP
      • 导入站点IP
    • pipeline-cert
      • 获取证书
      • 读取证书详情
    • pipeline-dns-provider
      • 查询DNS提供商列表
      • 查询DNS提供商类型字典
    • pipeline-notification
      • 查询通知配置分页列表
      • 查询通知配置列表
      • 添加通知配置
      • 更新通知配置
      • 查询通知配置详情
      • 删除通知配置
      • 查询通知插件定义
      • 查询通知类型字典
      • 查询通知配置简单信息
      • 查询默认通知配置ID
      • 设置默认通知配置
      • 获取或创建默认通知配置
      • 查询通知配置选项
    • pipeline
      • 查询流水线分页列表
      • 根据ID列表获取流水线简单信息
      • 新增/更新流水线
      • 删除流水线
      • 禁用流水线
      • 查询流水线详情
      • 触发流水线执行
      • 取消流水线执行
      • 查询流水线数量
      • 批量删除流水线
      • 刷新Webhook密钥
    • pipeline-group
      • 查询流水线分组分页列表
      • 查询流水线分组列表
      • 添加流水线分组
      • 更新流水线分组
      • 查询流水线分组详情
      • 删除流水线分组
      • 查询所有流水线分组
    • pipeline-plugin
      • 查询插件列表
      • 查询插件分组
      • 查询插件分组列表
      • 根据类型获取插件定义
      • 获取插件配置
    • dashboard
      • 查询仪表盘统计数据
  1. openapi

发送通知

开发环境
http://127.0.0.1:7001
开发环境
http://127.0.0.1:7001
POST
/api/v1/notification/send
通过指定通知渠道或默认通知渠道发送通知。
授权说明:
header 中传入 x-certd-token 即可调用开放接口。

请求参数

Authorization
API Key
在 header 添加参数
x-certd-token
示例:
x-certd-token: ********************
or
Body 参数application/json必填

示例
{
    "title": "证书部署失败",
    "content": "example.com 部署失败,请检查部署日志。",
    "url": "https://client.example.com/logs/123",
    "notificationType": "certDeployError"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'http://127.0.0.1:7001/api/v1/notification/send' \
--header 'x-certd-token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "title": "证书部署失败",
    "content": "example.com 部署失败,请检查部署日志。",
    "url": "https://client.example.com/logs/123",
    "notificationType": "certDeployError"
}'

返回响应

🟢200
application/json
请求已处理
Bodyapplication/json

示例
{
    "code": 0,
    "message": "success",
    "data": {
        "success": true
    }
}
修改于 2026-08-08 14:33:45
上一页
获取证书
下一页
查询授权配置分页列表
Built with