目录
企业评估报告API接口文档
本文档描述了产业智脑平台提供的企业评估报告相关API接口
文档概述
本文档详细描述了产业智脑平台提供的企业评估报告相关API接口,包括报告申请、状态查询等功能。 开发者可以通过这些接口集成企业评估报告功能到自己的应用中。
版本信息
API版本: v1
最后更新: 2026年1月5日
技术规格
通信协议: HTTPS
数据格式: JSON
基础信息
- 基础URL
-
需要向客服索取 - API版本
- v1
- 通信协议
- HTTPS
- 数据格式
- JSON
- 字符编码
- UTF-8
获取接入信息
认证方式
所有API请求都需要通过Bearer Token进行认证。用户需要先通过登录接口获取access_token, 然后在后续请求中使用该token进行认证。
请求头格式
Content-Type: application/json
认证Token获取
用户需要先通过登录接口获取access_token,然后在后续请求中使用该token进行认证。 Token可在个人中心查看获取。
统一响应格式
所有API接口返回统一的JSON格式响应,包含状态码、消息、数据和时间戳。
响应结构
字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | integer | 是 | 状态码,200表示成功 |
| message | string | 是 | 响应消息 |
| data | object | 否 | 响应数据 |
| timestamp | long | 是 | 时间戳(毫秒) |
常见状态码
接口列表
1. 企业报告申请接口
/outservice/applyCompanyReport
提交企业评估报告申请(form-data格式)
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| credit_code | string | 是 | 企业社会信用代码 |
| company_name | string | 是 | 企业工商全称 |
| attachment | file | 否 | 附件文件(PDF格式) |
请求示例
-H "Authorization: Bearer {access_token}" \
-F "credit_code=91310115MA1HXXXXXX" \
-F "company_name=上海某某科技有限公司" \
-F "attachment=@report.pdf"
成功响应
2. 企业报告查询接口
/outservice/getCompanyReport
查询企业评估报告状态和内容
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| report_id | string | 是 | 报告ID |
请求示例
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '{"report_id": "rep_20260105_123456789"}'
报告状态说明
响应示例
错误处理
统一错误响应格式
常见错误场景
认证相关错误
- 401: Token缺失或格式错误
- 401: Token已过期
- 403: 权限不足
业务相关错误
- 400: 参数格式错误
- 400: 企业信息不完整
- 404: 报告不存在
使用示例
JavaScript调用示例
const BASE_URL = '需要向客服索取';
const ACCESS_TOKEN = '你的访问令牌'; // 在个人中心查看
// 申请企业报告
async function applyCompanyReport(creditCode, companyName, attachmentFile) {
const formData = new FormData();
formData.append('credit_code', creditCode);
formData.append('company_name', companyName);
if (attachmentFile) {
formData.append('attachment', attachmentFile);
}
try {
const response = await fetch(`${BASE_URL}/outservice/applyCompanyReport`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${ACCESS_TOKEN}`
},
body: formData
});
const result = await response.json();
if (result.code === 200) {
console.log('报告申请成功,报告ID:', result.data.report_id);
return result.data.report_id;
} else {
throw new Error(result.message);
}
} catch (error) {
console.error('申请失败:', error.message);
throw error;
}
}
Python调用示例
# 基础配置(需要向客服索取)
BASE_URL = "需要向客服索取"
ACCESS_TOKEN = "你的访问令牌" # 在个人中心查看
def apply_company_report(credit_code, company_name, attachment_path=None):
"""申请企业评估报告"""
url = f"{BASE_URL}/outservice/applyCompanyReport"
headers = {
"Authorization": f"Bearer {ACCESS_TOKEN}"
}
files = {
"credit_code": (None, credit_code),
"company_name": (None, company_name)
}
if attachment_path:
files["attachment"] = ("report.pdf", open(attachment_path, "rb"), "application/pdf")
try:
response = requests.post(url, headers=headers, files=files)
result = response.json()
if result["code"] == 200:
print(f"报告申请成功,报告ID: {result['data']['report_id']}")
return result["data"]["report_id"]
else:
raise Exception(result["message"])
except Exception as e:
print(f"申请失败: {str(e)}")
raise
注意事项
安全注意事项
- Token安全: Access Token具有时效性,请妥善保管
- HTTPS传输: 必须使用HTTPS协议传输数据
- 参数校验: 客户端和服务端都应进行严格校验
- 文件上传: 附件需进行病毒扫描和格式验证
性能优化建议
- 批量查询: 建议使用批量接口查询多个报告
- 缓存机制: 客户端可缓存已完成的报告内容
- 轮询间隔: 建议5-10秒查询一次状态
限流策略
- 单个用户每分钟最多申请10次报告
- 单个用户每分钟最多查询50次报告状态
- 超出限制将返回429状态码