企业级人事背调API集成开发指南：从架构设计到安全实践

1. 客户端应用 --> (HTTPS加密请求) --> API网关

2. API网关 --> 认证与授权服务
   |--> a. 验证成功 --> 主查询控制器
   |--> b. 验证失败 --> (返回 401/403)

3. 主查询控制器 --> 身份核验服务
   |--> a. 核验成功 --> 并发查询任务分发器 (基于消息队列)
   |--> b. 核验失败 --> (返回身份验证失败)

4. 并发查询任务分发器 --> [并行的风险数据查询微服务集群]
   |--> 刑事犯罪扫描服务
   |--> 行政处罚扫描服务
   |--> 失信人识别服务
   |--> 限高人员识别服务
   |--> 不良记录扫描服务
   |--> 多头借贷扫描服务
   |--> 重大风险排查服务
   |--> 行为风险扫描服务
   |--> 投资记录调查服务
   |--> 高管任职记录调查服务
   |--> 涉董监高企业负面调查服务

5. [所有查询服务] --> 结果聚合与风险评估服务

6. 结果聚合与风险评估服务 --> 报告生成服务

7. 报告生成服务 --> (加密响应体) --> API网关

8. API网关 --> (加密响应) --> 客户端应用

{
  "name": "张三",
  "id_card": "110101199001011234",
  "mobile": "13800138000"
}

{
  "message": "查询完成",
  "code": 0,
  "request_id": "PRQ17508316075B",
  "data": { 
      // ... 各维度风险数据 ...
  }
}

from Crypto.Cipher import AES
from Crypto.Util.Padding import pad, unpad
from Crypto.Random import get_random_bytes
import base64
import json

class ApiDataCrypter:
    def __init__(self, hex_key: str):
        self.key = bytes.fromhex(hex_key)
        self.block_size = AES.block_size

    def encrypt(self, data: dict) -> str:
        plain_text = json.dumps(data, ensure_ascii=False).encode('utf-8')
        iv = get_random_bytes(self.block_size)
        cipher = AES.new(self.key, AES.MODE_CBC, iv)
        padded_data = pad(plain_text, self.block_size, style='pkcs7')
        encrypted_data = cipher.encrypt(padded_data)
        return base64.b64encode(iv + encrypted_data).decode('utf-8')

    def decrypt(self, b64_payload: str) -> dict:
        encrypted_bytes = base64.b64decode(b64_payload)
        iv = encrypted_bytes[:self.block_size]
        ciphertext = encrypted_bytes[self.block_size:]
        cipher = AES.new(self.key, AES.MODE_CBC, iv)
        padded_data = cipher.decrypt(ciphertext)
        decrypted_data = unpad(padded_data, self.block_size, style='pkcs7')
        return json.loads(decrypted_data.decode('utf-8'))