阿楠微创 - 图床 API 接入文档

接口说明:本接口提供极速的图片上传服务,上传成功后将返回可直接访问的 HTTPS 图片直链。

基础信息

POST 请求接口: https://aa.bdznt.help/upload

数据格式: multipart/form-data

请求头 (Headers): x-api-key : sk-xxxxxx

请求参数 (Body):

✅ 成功返回 (HTTP 状态码 200):

{
    "url": "https://aa.bdznt.help/uploads/17126583921-827361.jpg"
}

❌ 失败返回示例:

{"error": "Missing API Key"} (未提供密匙)
{"error": "Invalid API Key"} (密匙错误)
{"error": "API Key Expired"} (密匙已到期或被停权)
{"error": "No image uploaded"} (未找到图片参数)

📡 密匙状态查询接口

在对接前,您可以随时调用此接口验证您的 API Key 是否有效及剩余时长。

GET 请求接口: https://aa.bdznt.help/api/check

请求头 (Headers): x-api-key : 您的API_KEY

✅ 状态正常返回 (HTTP 200):

{
    "status": "active",
    "message": "密匙状态正常,可正常调用",
    "timeLeft": "剩余 29天 23小时",
    "expireTimestamp": 1715260000000
}

❌ 密匙已过期/需续费 (HTTP 403):

{
    "error": "API Key Expired",
    "message": "密匙已过期或被人工停权,请联系管理员续费"
}

❌ 密匙无效/输错了 (HTTP 403):

{
    "error": "Invalid API Key",
    "message": "密匙无效或不存在"
}