# NAC CEE 集成服务 API 参考

**版本**: 1.0.0  
**协议**: NAC_Lens/4.0  
**端口**: 9558  
**状态**: 生产级

---

## 健康检查接口

**端点**: `GET /health`  
**描述**: 返回 CEE 集成服务的完整健康状态

**响应示例**:
```json
{
  "service": "nac-cee-integration",
  "version": "1.0.0",
  "status": "healthy",
  "jurisdictions_loaded": 31,
  "total_tests_passed": 252,
  "cbpp_principles": {
    "constitutional_law_is_governance": true,
    "constitution_is_rules": true,
    "participation_is_consensus": true,
    "nodes_produce_blocks": true
  },
  "modules": {
    "nac-jurisdiction-rules": {
      "name": "NAC辖区宪法规则验证插件集（31辖区）",
      "status": "running",
      "test_count": 225,
      "version": "1.0.0"
    }
  }
}
```

---

## 交易验证接口

**端点**: `POST /validate`  
**描述**: 对指定辖区的交易进行宪法规则验证

**请求体**:
```json
{
  "jurisdiction": "CN",
  "tx_hash": "0xabcdef1234567890",
  "amount_usd": 5000.0,
  "asset_type": "RWA_REAL_ESTATE",
  "kyc_level": "Institutional",
  "aml_cleared": true,
  "is_cross_border": false,
  "sanctions_cleared": true
}
```

**响应体**:
```json
{
  "jurisdiction": "CN",
  "tx_hash": "0xabcdef1234567890",
  "valid": true,
  "cr_issued": true,
  "rules_passed": ["CN_AML_001", "CN_KYC_001", "CN_SANCTIONS_001"],
  "violation": null,
  "protocol": "NAC_Lens/4.0"
}
```

---

## 支持的辖区列表

| 层级 | 辖区代码 |
|------|---------|
| Tier 1 | CN, HK, SG, AE, US, EU, JP, KR, AU, CH, GB |
| Tier 2 | BM, KY, VG, MT, LU, GI, JE, IM, PA, MU |
| Tier 3 | BR, IN, TH, ID, NG, MX, ZA, TR, SA, RU |

---

## 错误码

| 错误码 | 描述 |
|--------|------|
| `{JUR}_AML_001` | AML 金额超限，需要反洗钱清除 |
| `{JUR}_KYC_001` | KYC 验证缺失 |
| `{JUR}_SANCTIONS_001` | 制裁筛查未通过 |
| `Jurisdiction not supported` | 不支持的辖区代码 |