• API 功能

    • 提供域名 SSL 证书信息解析;
    • 最完整 SSL 属性信息解析;
    • 支持多种元素信息抽取,包括主题的可辨识名称、颁发者的可辨识名称、序列号、有效起始日期、有效结束日期、签名算法、公钥信息、密钥用法、扩展密钥用法、基本约束、主题备用名称、颁发者备用名称、证书版本、证书签名、公钥算法、证书扩展信息;
    • 毫秒级解析性能,支持高并发;
    • 全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);
    • 全面兼容 Apple ATS;
    • 全国多节点 CDN 部署;
    • 接口极速响应,多台服务器构建 API 接口负载均衡。
    • 接口调用状态与状态监控
  • API 文档

    接口地址: https://api.gugudata.com/v2/websitetools/sslcertinfo

    返回格式: application/json; charset=utf-8

    请求方式: GET

    请求协议: HTTPS

    请求示例: https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE

    数据预览: https://www.gugudata.com/preview/sslcertinfo

    接口测试:  https://api.gugudata.com/v2/websitetools/sslcertinfo/demo

    OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

    请求参数(GET 请求方式可参见下方示例代码)

    参数名 参数类型 是否必须 默认值 备注
    appkey string YOUR_APPKEY 付费后获取的 APPKEY
    domain string YOUR_VALUE 需要解析的域名,格式为 https://www.gugudata.com

    返回参数

    参数名 参数类型 备注
    dataStatus.requestParameter string 请求的域名参数
    dataStatus.statusCode integer HTTP状态码
    dataStatus.status string 请求状态
    dataStatus.statusDescription string 请求状态的描述
    dataStatus.responseDateTime string 响应时间
    dataStatus.dataTotalCount integer 返回数据的总条数
    data.subjectDN string 主题的可辨识名称
    data.issuerDN string 颁发者的可辨识名称
    data.serialNumber string 序列号
    data.validFrom string 有效起始日期
    data.validTo string 有效结束日期
    data.signatureAlgorithm string 签名算法
    data.publicKey string 公钥信息
    data.keyUsage string 密钥用法
    data.extendedKeyUsage string 扩展密钥用法
    data.basicConstraints string 基本约束
    data.subjectAlternativeNames string 主题备用名称
    data.issuerAlternativeNames string 颁发者备用名称
    data.version string 证书版本
    data.signature string 证书签名
    data.publicKeyAlgorithm string 公钥算法
    data.extensions string 证书扩展信息
  • 接口 HTTP 响应标准状态码

    状态码 状态码解释 备注
    200 接口正常响应 请求成功,业务状态请结合响应体中的自定义业务码判断。
    400 请求参数错误 请求参数缺失、格式错误或参数组合不合法。
    401 鉴权失败 缺少 appkey 或 appkey 无效。
    403 无权限访问 订单到期、权限不足或接口额度不可用。
    404 资源不存在 请求路径不存在。
    405 请求方法不允许 当前路径不支持该 HTTP 方法。
    415 请求内容类型不支持 上传或请求体的内容类型不符合接口要求。
    429 请求频率受限 请求频率超过服务限制,请适当降低调用速率。
    500 服务内部错误 服务端处理异常,请稍后重试。
    502 上游依赖错误 上游依赖服务不可用或返回异常。
  • 接口自定义状态码

    自定义状态码 自定义状态码解释 备注
    200 正常返回
    400 参数错误
    429 请求频率受限 每秒请求不能超过 100 次
    403 账号欠费 请及时关注订单到期短信提醒
    402 APPKEY 错误 请检查传递的 APPKEY 是否为开发者中心获取到的值
    500 接口响应错误
  • 请求示例代码
    curl --location --request GET 'https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE'
    #include <curl/curl.h>
    
    int main(void) {
      CURL *curl = curl_easy_init();
      if (curl) {
        curl_easy_setopt(curl, CURLOPT_URL, "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE");
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
        CURLcode res = curl_easy_perform(curl);
        (void)res;
        curl_easy_cleanup(curl);
      }
      return 0;
    }
    
    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Net.Http;
    
    var client = new HttpClient();
    var request = new HttpRequestMessage(HttpMethod.Get, "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE");
    var response = client.SendAsync(request).Result;
    Console.WriteLine(response.Content.ReadAsStringAsync().Result);
    
    package main
    
    import (
      "fmt"
      "io"
      "net/http"
    )
    
    func main() {
      url := "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE"
      req, err := http.NewRequest("GET", url, nil)
      if err != nil {
        fmt.Println(err)
        return
      }
      res, err := http.DefaultClient.Do(req)
      if err != nil {
        fmt.Println(err)
        return
      }
      defer res.Body.Close()
      body, err := io.ReadAll(res.Body)
      if err != nil {
        fmt.Println(err)
        return
      }
      fmt.Println(string(body))
    }
    
    OkHttpClient client = new OkHttpClient().newBuilder().build();
    Request request = new Request.Builder()
      .url("https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE")
      .method("GET", null)
      .build();
    Response response = client.newCall(request).execute();
    System.out.println(response.body().string());
    
    $.ajax({
      url: "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE",
      method: "GET",
    }).done(function (response) {
      console.log(response);
    });
    
    const response = await fetch("https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE", {
      method: "GET"
    });
    console.log(await response.text());
    
    const response = await fetch("https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE", {
      method: "GET"
    });
    console.log(await response.text());
    
    #import <Foundation/Foundation.h>
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE"]];
    [request setHTTPMethod:@"GET"];
    NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
      if (error) {
        NSLog(@"%@", error);
        return;
      }
      NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
    }];
    [task resume];
    
    <?php
    $curl = curl_init();
    curl_setopt_array($curl, array(
      CURLOPT_URL => "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_FOLLOWLOCATION => true,
      CURLOPT_CUSTOMREQUEST => "GET",
    ));
    $response = curl_exec($curl);
    curl_close($curl);
    echo $response;
    
    import requests
    
    url = "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE"
    response = requests.request("GET", url)
    print(response.text)
    
    require "uri"
    require "net/http"
    
    url = URI("https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE")
    https = Net::HTTP.new(url.host, url.port)
    https.use_ssl = true
    request = Net::HTTP::Get.new(url)
    response = https.request(request)
    puts response.read_body
    
    import Foundation
    
    let semaphore = DispatchSemaphore(value: 0)
    var request = URLRequest(url: URL(string: "https://api.gugudata.com/v2/websitetools/sslcertinfo?appkey=YOUR_APPKEY&domain=YOUR_VALUE")!, timeoutInterval: .infinity)
    request.httpMethod = "GET"
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
      defer { semaphore.signal() }
      guard let data = data else {
        print(String(describing: error))
        return
      }
      print(String(data: data, encoding: .utf8)!)
    }
    task.resume()
    semaphore.wait()
    
  • 常见问题 Q&A

    • Q: 数据请求有缓存吗?

      A: 我们为所有数据请求提供实时响应。对于定期更新的数据,我们在其更新周期内实施缓存策略,以优化性能。

    • Q: 如何保证请求时 key 的安全性?

      A: 我们建议将对 API 的请求操作放置在您的应用程序后端。这样,前端请求只与您的后端服务交互,确保了更高的安全性和易于维护的架构。

    • Q: 接口可以用于哪些开发语言?

      A: 我们的接口支持所有能进行网络请求的开发语言,便于在各类项目中快速整合数据。

    • Q: 接口的性能可以保证吗?

      A: 我们的接口后台使用与商业级项目相同的架构,保证了稳定且高效的性能。您可以通过访问测试接口了解更多性能信息。

  • 服务协议以及服务免责声明

    用户应当充分阅读 服务协议 以及 服务免责声明 ,用户购买与使用咕咕数据 API 服务亦视为接受本协议。

  • 技术支持

    • 技术支持邮箱: support@gugudata.com
    • 微信客服: 客服链接

业务相关接口推荐

稳定提供服务 10 年 通用二维码解析读取
  • 提供通用的二维码解码接口
  • 二维码解码 / 支持多种字段属性
  • 999元/年限时折扣 299元/年
查看详情 被调用于 4 秒前
30% 折扣
域名 DNS 信息查询
  • 多种记录类型数据返回
  • 丰富信息结构 / 毫秒级响应
  • 599元/年限时折扣 299元/年
查看详情 被调用于 7 秒前
50% 折扣
稳定提供服务 10 年 网页可读内容抽取
  • 智能提取文章关键元素信息
  • 智能抽取 / 多种元素信息
  • 999元/年限时折扣 499元/年
查看详情 被调用于 1 秒前
50% 折扣
稳定提供服务 10 年 域名 Whois 查询
  • 多类型域名支持
  • 精准 Whois 数据 / 实时数据
  • 599元/年限时折扣 299元/年
查看详情 被调用于 1 秒前
50% 折扣