Python中使用.p12证书与订阅密钥连接API遇问题求助

作为API新手，碰到证书认证这类细节问题确实容易懵，我帮你梳理下两种方法的问题，再给出可行的解决方案，同时解答你关于data变量的疑问。

先分析你现有代码的问题 #

第一种方法（requests_pkcs12） #

这个思路是对的，requests_pkcs12库专门处理PKCS12证书的认证，不过可能存在两个潜在问题：

1. 如果你调用的是POST接口且需要提交请求体，你的代码里没有传递data或json参数，API可能会返回错误
2. verify=False会关闭SSL证书校验，生产环境绝对不能这么用，测试环境可以临时用，正式环境要指定可信CA证书

第二种方法（http.client） #

这个方法的问题比较明显：你把证书路径和密码放在请求头里是完全错误的——HTTPS证书认证是在TCP握手阶段完成的，不是通过请求头传递的。http.client.HTTPSConnection需要通过context参数传入加载好的SSL上下文，而不是在headers里加file和password。

可行的解决方案 #

方案1：用requests_pkcs12（推荐，更简洁） #

如果API需要POST JSON数据，补充json参数；如果是GET请求，把post换成get即可：

import json
from requests_pkcs12 import post, get

# 配置信息
url = 'https://your-api-endpoint'
pkcs12_path = '<你的.p12证书路径>'
pkcs12_password = '<证书密码>'
subscription_key = '<你的订阅密钥>'

headers = {
    'Subscription-Key': subscription_key,
    'Content-Type': 'application/json'  # 如果是JSON请求体，需要加这个头
}

# 如果是POST请求，准备请求体数据
payload = {
    "key1": "value1",
    "key2": "value2"
}

# 发送请求（GET的话把post换成get，去掉json参数）
response = post(
    url,
    headers=headers,
    json=payload,  # 或者用data=json.dumps(payload)，但json参数更方便
    pkcs12_filename=pkcs12_path,
    pkcs12_password=pkcs12_password,
    # verify=True  # 生产环境打开，指定CA证书路径或设为True用系统默认
)

print(f"状态码: {response.status_code}")
print(f"响应内容: {response.text}")

方案2：用标准库ssl + http.client #

如果不想用第三方库，可以用ssl模块加载PKCS12证书，再传给http.client.HTTPSConnection：

import http.client
import ssl
import json

# 配置信息
api_host = '<API的主机名，比如api.example.com>'
api_path = '<API的路径，比如/v1/resource>'
pkcs12_path = '<你的.p12证书路径>'
pkcs12_password = '<证书密码>'.encode('utf-8')  # 需要字节类型
subscription_key = '<你的订阅密钥>'

# 加载PKCS12证书，创建SSL上下文
context = ssl.create_default_context()
context.load_pkcs12(pkcs12_path, pkcs12_password)

# 建立连接并发送请求
conn = http.client.HTTPSConnection(api_host, context=context)

# 如果是POST请求，准备请求体
payload = json.dumps({
    "key1": "value1",
    "key2": "value2"
})

headers = {
    'Subscription-Key': subscription_key,
    'Content-Type': 'application/json'
}

# 发送请求（GET的话把"POST"换成"GET"，payload传空字符串）
conn.request("POST", api_path, body=payload, headers=headers)

response = conn.getresponse()
data = response.read()

print(f"Status: {response.status} and reason: {response.reason}")
print(f"响应内容: {data.decode('utf-8')}")

conn.close()

关于data变量的疑问 #

你提到的data（也就是我代码里的payload）是请求体内容，是否需要传取决于API的要求：

• 如果是GET请求：通常不需要请求体，所以conn.request的body参数传空字符串或者省略
• 如果是POST/PUT/PATCH请求：API一般会要求你提交数据（比如JSON、表单等），这时候data就是你要发送给API的具体内容，格式要和API文档要求一致（比如JSON格式就需要先转成字符串）

如果API文档没有明确说明请求体格式，可以查看接口的示例请求，或者联系API提供者确认。

内容的提问来源于stack exchange，提问作者Sree Kavya