API接口

概述

接口 提供了证书查询和下载功能，支持通过 API 密钥进行身份验证和 IP 白名单访问控制。

基础URL :

https://ssl-api.luosimao.com

认证方式

API 支持多种认证方式：

1. Authorization Header (推荐)

   Authorization: Bearer YOUR_API_TOKEN

2. X-API-Key Header

   X-API-Key: YOUR_API_TOKEN

3. Query Parameter

   ?key=YOUR_API_TOKEN

接口列表

1. 获取证书信息

获取证书的详细信息，包括域名、证书内容、私钥和过期时间。

请求信息

• URL : /api/certificate
• 方法 : GET
• 认证 : 必需 请求示例

curl -X GET "https://ssl-api.luosimao.com/api/
certificate" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

响应格式

{
  "status": "success",
  "data": {
    "certificate_info": {
      "domains": ["example.com", "www.example.com"],
      "certificate": "-----BEGIN 
      CERTIFICATE-----\n...",
      "private_key": "-----BEGIN PRIVATE 
      KEY-----\n...",
      "expires_at": "2024-12-31 23:59:59"
    }
  }
}

响应字段说明

• domains : 证书包含的域名列表
• certificate : PEM 格式的证书内容
• private_key : PEM 格式的私钥内容
• expires_at : 证书过期时间

2. 下载证书文件

直接下载证书或私钥文件，支持命令行工具使用。

请求信息

• URL : /api/download
• 方法 : GET
• 认证 : 必需 请求参数

请求参数

参数名	类型	必需	默认值	说明
type	string	否	certificate	下载类型：certificate（证书）或key（私钥）

请求示例

下载证书文件：

curl -X GET "https://ssl-api.luosimao.com/api/
download?type=certificate" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -o certificate.crt

下载私钥文件：

curl -X GET "https://ssl-api.luosimao.com/api/
download?type=key" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -o private.key

响应格式

• Content-Type : application/x-pem-file
• Content-Disposition : attachment; filename="域名.crt" 或 attachment; filename="域名.key"
• 响应体 : PEM 格式的证书或私钥内容

错误响应

当请求失败时，API 会返回错误信息：

{
  "status": "error",
  "message": "错误描述",
  "timestamp": 1640995200
}

常见错误

错误信息	说明
缺少API密钥	请求中未提供有效的API密钥
无效的API密钥	提供的API密钥无效或已禁用
当前API密钥未授权访问	API密钥未配置部署权限
当前IP未授权访问	请求IP不在白名单中
未找到有效的证书	该API密钥关联的证书不存在或未完成
无效的下载类型	download接口的type参数值无效