企业评估报告API接口文档

本文档描述了产业智脑平台提供的企业评估报告相关API接口

文档概述

本文档详细描述了产业智脑平台提供的企业评估报告相关API接口,包括报告申请、状态查询等功能。 开发者可以通过这些接口集成企业评估报告功能到自己的应用中。

版本信息

API版本: v1

最后更新: 2026年1月5日

技术规格

通信协议: HTTPS

数据格式: JSON

基础信息

基础URL
需要向客服索取
API版本
v1
通信协议
HTTPS
数据格式
JSON
字符编码
UTF-8

获取接入信息

基础URL获取:请联系客服获取API基础URL地址
接口申请:如需使用企业评估报告API接口,请向客服申请接口权限
Token获取:API访问Token可在个人中心查看获取

认证方式

所有API请求都需要通过Bearer Token进行认证。用户需要先通过登录接口获取access_token, 然后在后续请求中使用该token进行认证。

请求头格式

Authorization: Bearer {access_token}
Content-Type: application/json

认证Token获取

用户需要先通过登录接口获取access_token,然后在后续请求中使用该token进行认证。 Token可在个人中心查看获取。

统一响应格式

所有API接口返回统一的JSON格式响应,包含状态码、消息、数据和时间戳。

响应结构

{ "code": 200, "message": "string", "data": {}, "timestamp": 1704067200000 }

字段说明

字段 类型 必填 说明
code integer 状态码,200表示成功
message string 响应消息
data object 响应数据
timestamp long 时间戳(毫秒)

常见状态码

200 请求成功
400 请求参数错误
401 未授权/Token过期
403 权限不足
404 资源不存在
500 服务器内部错误

接口列表

1. 企业报告申请接口

POST /outservice/applyCompanyReport

提交企业评估报告申请(form-data格式)

请求参数

参数名 类型 必填 说明
credit_code string 企业社会信用代码
company_name string 企业工商全称
attachment file 附件文件(PDF格式)

请求示例

curl -X POST "{BASE_URL}/outservice/applyCompanyReport" \
  -H "Authorization: Bearer {access_token}" \
  -F "credit_code=91310115MA1HXXXXXX" \
  -F "company_name=上海某某科技有限公司" \
  -F "attachment=@report.pdf"

成功响应

{ "code": 200, "message": "报告申请提交成功", "data": { "report_id": "rep_20260105_123456789" }, "timestamp": 1704454800000 }

2. 企业报告查询接口

POST /outservice/getCompanyReport

查询企业评估报告状态和内容

请求参数

参数名 类型 必填 说明
report_id string 报告ID

请求示例

curl -X POST "{BASE_URL}/outservice/getCompanyReport" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"report_id": "rep_20260105_123456789"}'

报告状态说明

0 生成失败
1 准备中
2 准备完成
3 正在生成中
88 生成完成

响应示例

{ "code": 200, "message": "查询成功", "data": { "report_status": "88", "create_date": "2026-01-05T10:30:00Z", "end_date": "2026-01-05T11:15:30Z", "md_content": "# 企业评估报告\n\n## 基本信息\n- 企业名称:上海某某科技有限公司\n- 社会信用代码:91310115MA1HXXXXXX\n- 评估时间:2026-01-05\n\n## 评估结果\n..." }, "timestamp": 1704454800000 }

错误处理

统一错误响应格式

{ "code": 401, "message": "Token已过期,请重新登录", "data": null, "timestamp": 1704454800000 }

常见错误场景

认证相关错误

  • 401: Token缺失或格式错误
  • 401: Token已过期
  • 403: 权限不足

业务相关错误

  • 400: 参数格式错误
  • 400: 企业信息不完整
  • 404: 报告不存在

使用示例

JavaScript调用示例

// 配置API基础URL(需要向客服索取)
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调用示例

import requests

# 基础配置(需要向客服索取)
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状态码