No-Code Integration Blueprint

ISIN 流程

Method: GET
URL: https://api.isvalid.dev/v0/isin?value={{isin_input}}
Headers:
  Accept: application/json
  User-Agent: [your-app]/1.0
  Authorization: Bearer {{ISVALID_API_KEY}}
Rate Limit: according to your API plan

• 在 API 调用之前验证本地格式：正好 12 个字符。
• 在生产中，在环境中配置 API 密钥 (ISVALID_API_KEY)。
• 如果有效，则提取 fisin、cfi_code、货币、lei 和 Figi。
• 如果是 429，则应用回退和指数重试。

SWIFT/BIC 流程

Method: GET
URL: https://api.isvalid.dev/v0/bic?value={{bic_input}}
Headers:
  Accept: application/json
  Authorization: Bearer {{ISVALID_API_KEY}}
Regex BIC: /^[A-Z]{6}[A-Z0-9]{2}([A-Z0-9]{3})?$/

• 无效格式会立即返回错误。
• 有效格式查询 API 并确认机构、国家和城市。
• 最终状态：BIC 已确认或 BIC 未找到。

SBLC / DLC 流程

• 没有可信赖的免费公共 API 可用于直接验证。
• 执行间接验证：发行人 BIC 加上受信任的代理银行列表。
• 通过官方SWIFT渠道（MT799/MT760/MT767）打开手动任务进行确认。

建议的数据存储

{
  "id": "uuid",
  "tipo_documento": "ISIN|SWIFT|SBLC|DLC",
  "valor_documento": "string",
  "status_validacao": "PENDENTE|VALIDO|INVALIDO|ERRO|MANUAL",
  "data_validacao": "timestamp",
  "fonte_validacao": "isvalid|swiftref|manual",
  "dados_resposta": {"json_original": "{}"},
  "flags": {"alerta_fraude": true, "requer_acao_manual": false}
}

重试、安全性和合规性

• 重试： 500/502/503/429 进行 3 次指数退避尝试（1 秒、2 秒、4 秒）。
• 使用 HTTPS、清理输入并按用户/IP 强制实施速率限制。
• 不要以纯文本形式记录敏感文档。
• LGPD/GDPR：同意、保留期、导出和删除工作流程。